当前位置：首页 > news >正文

arthas-boot.jar 热替换

news 2026/5/13 1:16:36

下载 arthas-boot.jar

curl-Ohttps://arthas.aliyun.com/arthas-boot.jar

一、现在你还没进 Arthas（很重要）

你刚才只是ls和pwd，
还没有真正 attach JVM。

👉 现在请执行这一条命令：

java-jararthas-boot.jar

二、你接下来一定会看到这个界面（正常）

类似这样 👇

Found existing java process, please choose one and hit RETURN. * [1]: 23145 demo20250304-0.0.1-SNAPSHOT.jar

👉 你要做的事：

看清楚是你这个 jar：
```
demo20250304-0.0.1-SNAPSHOT.jar
```
输入前面的数字，比如：

然后回车

三、看到这个，说明你成功进 Arthas 了 ✅

Welcome to Arthas!

并且命令行前缀会变成：

[arthas@23145]$

到这一步，你已经成功 attach 正在运行的 JVM
后面所有操作，都是不重启、直接改内存

四、定位 BookController（第一条 Arthas 命令）

在 Arthas 控制台里，输入👇：

sc *BookController*

正常你会看到类似：

com.example.demo.controller.BookController

👉把这个完整包名记住

假设是：

com.example.demo.controller.BookController

五、确认类信息（非常重要，不跳）

sc-dcom.example.demo.controller.BookController

你主要看两点：

classLoaderHash
location（一般是 BOOT-INF/classes）

只要能正常显示，就可以 redefine

六、现在开始真正热替换（核心一步）

⚠️ 注意：
这条命令里的路径，是 Linux 绝对路径

你的 class 在：

/root/1230/BookController.class

👉 在 Arthas 控制台中执行：

redefine /root/1230/BookController.class

七、成功标志（你要看到这个）

redefine success, size: 1

🎉恭喜你，此时：

❌ 没有重启 jar
❌ 没有改磁盘 jar
✅ BookController 的新逻辑已在 JVM 内存中生效

八、立刻验证（必须做）

方式一：直接调接口

curlhttp://localhost:8080/你BookController的接口

方式二：看日志（强烈推荐）

如果你在新代码里加了类似：

log.info("=== arthas hotfix ===");

那你现在一请求接口，就应该能看到。

九、如果 redefine 报错（别慌，对号入座）

❌ 报`VerifyError`

👉 你改了方法签名 / 字段 / 注解

❌ 报`Unsupported major.minor`

👉 class 编译 JDK 和线上不一致

❌ 提示找不到 class

👉 说明这个 Controller 还没被加载（极少）

十、非常重要的一句话（老工程师经验）

Arthas 热修 = 临时止血
一定要记得：后续正常打包 + 重启发布

否则：

JVM 一重启
你的修改就全部消失

[root@VM-12-7-centos1230]# java -jar arthas-boot.jar[INFO]JAVA_HOME: /usr/lib/jvm/java-1.8.0-openjdk-1.8.0.412.b08-1.el7_9.x86_64/jre[INFO]arthas-boot version:4.1.4[INFO]Found existingjavaprocess, please choose one and input the serial number of the process, eg:1. Then hit ENTER. *[1]:20038demo20250304-0.0.1-SNAPSHOT.jar1[INFO]arthas home: /root/.arthas/lib/4.1.4/arthas[INFO]Try to attach process20038Picked up JAVA_TOOL_OPTIONS:[INFO]Attach process20038success.[INFO]arthas-client connect127.0.0.13658,---. ,------. ,--------.,--. ,--. ,---. ,---. / O\|.--.''--. .--'| '--' | / O \ '.-' | .-. || '--'.'|||.--.||.-.|`.`-.||||||\\||||||||||.-' | `--'`--'`--' '--' `--'`--'`--'`--'`--'`-----' wiki https://arthas.aliyun.com/doc tutorials https://arthas.aliyun.com/doc/arthas-tutorials.html version4.1.4 main_class demo20250304-0.0.1-SNAPSHOT.jar pid20038start_time2025-12-31 00:14:37.452 current_time2025-12-31 00:15:05.480[arthas@20038]$ redefine /root/1230/BookController.class redefine success, size:1, classes: com.example.demo20250304.controller.BookController[arthas@20038]$