1. 结合 jad/mc 命令在线修改使用
jad
命令: 将 JVM 中实际运行的 class 的 byte code 反编译成 java 代码,便于你理解业务逻辑;
mc命令:Memory Compiler/内存编译器,编译.java
文件生成.class
。
redefine命令:加载外部的.class
文件,redefine jvm 已加载的类。
步骤:
1. 使用 jad 将.class导出为 .java
jad --source-only demo.MathGame > /tmp/MathGame.java
修改对应导出 .java文件
2. 使用 mc 将修改的 .java文件编译为 .class文件
[arthas@3434]$ mc /tmp/MathGame.java -d /tmp/
Memory compiler output:
/tmp/demo/MathGame.class
Affect(row-cnt:1) cost in 795 ms.
3. 使用redefine 将编译好的 .class文件更新到 jvm
[arthas@3434]$ redefine /tmp/demo/MathGame.class
redefine success, size: 1, classes:
demo.MathGame
结果:
2. 直接上传修改好的 java文件更新
本地修改代码,将修改好的java文件上传到服务器
[arthas@5230]$ mc /tmp/MathGame.java -d /tmp/
Memory compiler output:
/tmp/demo/MathGame.class
Affect(row-cnt:1) cost in 50 ms.
[arthas@5230]$ redefine /tmp/demo/MathGame.class
redefine success, size: 1, classes:
demo.MathGame
[arthas@5230]$
更新后的结果:
注意事项:
1. 保证你的arthas运行环境和监控的项目运行环境是一致的,是jdk而不是jre(最好环境变量中配置也是jdk)
2. mc 命令有可能失败。如果编译失败可以在本地修改好java文件,再上传到服务器通过mc命令编译。(如上:2. 直接上传修改好的 java文件更新 )
3. redefine 后的原来的类不能恢复,redefine 有可能失败(比如增加了新的 field)
4.
redefine 与
Retransform限制
- 不允许新增加 field/method
- 正在跑的函数,没有退出不能生效
5.redefine
命令和jad
/watch
/trace
/monitor
/tt
等命令会冲突。执行完redefine
之后,如果再执行上面提到的命令,则会把redefine
的字节码重置。 原因是 jdk 本身 redefine 和 Retransform 是不同的机制,同时使用两种机制来更新字节码,只有最后修改的会生效。可以使用命令 retransform 来代替 redefine ,如下演示
这里我热更新成功后,再次执行 jad 后 jad重置了我热更新的class文件:
[arthas@5230]$ jad --source-only demo.MathGame
/*
* Decompiled with CFR.
*/
package demo;
import java.util.ArrayList;
import java.util.List;
import java.util.Random;
import java.util.concurrent.TimeUnit;
public class MathGame {
private static Random random = new Random();
private int illegalArgumentCount = 0;
public List<Integer> primeFactors(int n) {
/*16*/ if (n < 2) {
/*17*/ ++this.illegalArgumentCount;
throw new IllegalArgumentException("number is: " + n + ", need >= 2");
}
ArrayList<Integer> arrayList = new ArrayList<Integer>();
/*21*/ int n2 = 2;
/*22*/ while (n2 <= n) {
/*23*/ if (n % n2 == 0) {
/*24*/ arrayList.add(n2);
/*25*/ n /= n2;
/*26*/ n2 = 2;
/*27*/ continue;
}
/*29*/ ++n2;
}
/*31*/ return arrayList;
}
public static void main(String[] stringArray) throws InterruptedException {
MathGame mathGame = new MathGame();
while (true) {
/*37*/ mathGame.run();
/*38*/ TimeUnit.SECONDS.sleep(1L);
}
}
public void run() throws InterruptedException {
try {
/*44*/ int n = random.nextInt() / 10000;
/*45*/ List<Integer> list = this.primeFactors(n);
/*46*/ MathGame.print(n, list);
}
catch (Exception exception) {
/*49*/ System.out.println(String.format("-----------------illegalArgumentCount:%3d, ", this.illegalArgumentCount) + exception.getMessage());
}
}
public static void print(int n, List<Integer> list) {
StringBuffer stringBuffer = new StringBuffer(n + "=");
/*55*/ for (int n2 : list) {
/*56*/ stringBuffer.append(n2).append('*');
}
/*58*/ if (stringBuffer.charAt(stringBuffer.length() - 1) == '*') {
/*59*/ stringBuffer.deleteCharAt(stringBuffer.length() - 1);
}
/*61*/ System.out.println(stringBuffer);
}
}
[arthas@5230]$
重新编译,使用 retransform 热更新后正常使用 jad 并且不会重置:
[arthas@5230]$ retransform /tmp/demo/MathGame.class
retransform success, size: 1, classes:
demo.MathGame
[arthas@5230]$
补充:
消除 retransform 的影响
如果对某个类执行 retransform 之后,想消除影响,则需要:
- 删除这个类对应的 retransform entry
- 重新触发 retransform
如果不清除掉所有的 retransform entry,并重新触发 retransform ,则 arthas stop 时,retransform 过的类仍然生效。
查看 retransform entry
$ retransform -l
Id ClassName TransformCount LoaderHash LoaderClassName
1 demo.MathGame 1 null null
- TransformCount 统计在 ClassFileTransformer#transform 函数里尝试返回 entry 对应的 .class 文件的次数,但并不表明 transform 一定成功。
删除指定 retransform entry
需要指定 id:
retransform -d 1
删除所有 retransform entry
retransform --deleteAll
显式触发 retransform
$ retransform --classPattern demo.MathGame
retransform success, size: 1, classes:
demo.MathGame
注意:对于同一个类,当存在多个 retransform entry 时,如果显式触发 retransform ,则最后添加的 entry 生效(id 最大的)。