Arthas 线上诊断实战

Arthas 适用场景：
  生产环境偶发问题，日志不够用
  排查慢接口、死锁、内存异常
  临时热修复（有风险，需走流程）
  排查类冲突、依赖版本问题

# 下载 arthas-boot，或用包管理工具
curl -O https://arthas.aliyun.com/arthas-boot.jar
java -jar arthas-boot.jar

# 交互选择要 attach 的 Java 进程，或直接指定 PID
java -jar arthas-boot.jar <pid>

# 也可以作为服务启动，支持远程连接
java -jar arthas-as-service.jar

进入 Arthas 交互界面后：
  help        查看所有命令
  quit        退出（不影响目标进程）
  session     查看当前会话信息
  reset       重置所有增强过的类（恢复原始字节码）
  shutdown    关闭 Arthas 服务端

# 非交互方式：attach 后执行单条命令即退出
java -jar arthas-boot.jar --attach-only <pid>
# 或通过 telnet/HTTP 接口脚本化调用

# 仪表盘：实时显示 CPU、内存、GC、线程概览
dashboard

# 查看所有线程及状态
thread

# 找出 CPU 占用最高的线程（Top 20）
thread -n 20

# 查看某个线程的完整堆栈
thread <threadId>

# 查看线程是否阻塞、等什么锁
thread -b

thread -b 输出解读：
  如果有输出 → 找到了持锁线程，是死锁/锁等待的元凶
  输出为空   → 没有线程在阻塞，问题可能是 IO 或 CPU 忙

# watch：观测方法调用的入参、返回、异常
watch com.example.OrderService placeOrder '{params, returnObj, throwExp}' -x 3

# trace：跟踪方法内部每一层的耗时
trace com.example.OrderService placeOrder

# 带条件观测：只有耗时超过 200ms 才打印
watch com.example.OrderService placeOrder '{params[0].userId}' '#cost > 200'

# 查看线上真实运行的类源码（含行号）
jad com.example.OrderServiceImpl

# 只反编译某个方法
jad --source-only com.example.OrderServiceImpl placeOrder

# 定位类是从哪个 jar 加载的
sc -d com.example.OrderServiceImpl

jad 的价值：
  1. 确认线上跑的到底是哪个版本的代码
  2. 看字节码增强后的真实逻辑（是否有代理/包装）
  3. 排查反编译结果与源码不一致 → 版本漂移

# 1. 本地编译新代码
mc /tmp/Fix.java -d /tmp/out

# 2. 用编译产物替换运行中的类
redefine -c <classloaderHash> /tmp/out/com/example/Fix.class

# 3. 验证增强
jad com.example.Fix

// 一个临时修复的例子：原代码返回空导致 NPE
public class Fix {
    public static String getConfig(String key) {
        return "default_value";   // 临时兜底值
    }
}

# 高 CPU 定位：先找最耗 CPU 的线程，再看它的栈
thread -n 10

# 死锁检测
thread -b

# 锁竞争观察：配合 watch 看锁等待耗时
watch java.util.concurrent.locks.ReentrantLock lock '{params[0]}' -n 5

# 查看堆使用概况
memory

# 查看 GC 情况
gc

# 查看类加载器及加载的类数量
classloader

# 查看某个类的实例数量与大小（需要开启）
# vmtool --action getInstances --className com.example.Cache --limit 100

Arthas 与堆转储的配合：
  Arthas 适合快速看对象实例、类加载、GC 状态
  大堆对象 / 引用链分析还是用 MAT 更全面
  先用 Arthas 缩小范围，再 dump 给 MAT 深挖

# 一层层展开，找到耗时子方法
trace -n 3 com.example.OrderService placeOrder '#cost > 100'

# 同时观测多个方法
trace com.example.OrderService placeOrder com.example.InventoryService checkStock

trace 输出解读：
  每一行是一个子方法调用，右侧是耗时
  看占比最大的子调用，就是慢的根源
  继续对慢子方法再 trace，逐层下钻

# 读取静态字段
ognl '@com.example.Config@INSTANCE.timeout'

# 调用方法
ognl '@java.lang.System@getProperty("user.dir")'

# 修改静态字段（谨慎！）
ognl -x 3 '@com.example.Config@INSTANCE.timeout = 5000'

OGNL 的边界：
  能读：静态字段、对象属性、方法返回值
  能改：静态字段、属性（慎用，影响所有线程）
  不能：修改方法字节码、新增字段

生产环境 Arthas 使用规范：
  1. 仅在低峰期、白名单机器使用
  2. 观测命令必须带 -n 限制，防止无限输出
  3. 用完立即 reset / quit，不留增强字节码
  4. 远程访问走安全通道（SSH 隧道 / HTTP 鉴权）
  5. redefine 必须记录变更内容与时间，配套正式发布

# SSH 隧道远程访问 Arthas 的典型姿势
ssh -L 8563:localhost:8563 user@host
# 本地再通过 http://localhost:8563 访问 Arthas WebConsole