redefine

推荐使用 retransform 命令

mc-redefine在线教程

加载外部的.class文件，redefine jvm已加载的类。

参考：Instrumentation#redefineClasses

常见问题

推荐使用 retransform 命令

  • redefine的class不能修改、添加、删除类的field和method，包括方法参数、方法名称及返回值

  • 如果mc失败，可以在本地开发环境编译好class文件，上传到目标系统，使用redefine热加载class

  • 目前redefine 和watch/trace/jad/tt等命令冲突，以后重新实现redefine功能会解决此问题

注意， redefine后的原来的类不能恢复，redefine有可能失败（比如增加了新的field），参考jdk本身的文档。

reset命令对redefine的类无效。如果想重置，需要redefine原始的字节码。

redefine命令和jad/watch/trace/monitor/tt等命令会冲突。执行完redefine之后，如果再执行上面提到的命令，则会把redefine的字节码重置。 原因是jdk本身redefine和Retransform是不同的机制，同时使用两种机制来更新字节码，只有最后修改的会生效。

参数说明

参数名称参数说明
[c:]ClassLoader的hashcode
[classLoaderClass:]指定执行表达式的 ClassLoader 的 class name

使用参考

  1.    redefine /tmp/Test.class
  2.    redefine -c 327a647b /tmp/Test.class /tmp/Test\$Inner.class
  3.    redefine --classLoaderClass sun.misc.Launcher$AppClassLoader /tmp/Test.class /tmp/Test\$Inner.class

结合 jad/mc 命令使用

  1. jad --source-only com.example.demo.arthas.user.UserController > /tmp/UserController.java
  3. mc /tmp/UserController.java -d /tmp
  5. redefine /tmp/com/example/demo/arthas/user/UserController.class

  • jad命令反编译，然后可以用其它编译器，比如vim来修改源码

  • mc命令来内存编译修改过的代码

  • 用redefine命令加载新的字节码

上传 .class 文件到服务器的技巧

使用mc命令来编译jad的反编译的代码有可能失败。可以在本地修改代码，编译好后再上传到服务器上。有的服务器不允许直接上传文件，可以使用base64命令来绕过。

  1. 在本地先转换.class文件为base64，再保存为result.txt

    1. base64 < Test.class > result.txt

  2. 到服务器上，新建并编辑result.txt，复制本地的内容，粘贴再保存

  3. 把服务器上的 result.txt还原为.class

    1. base64 -d < result.txt > Test.class

  4. 用md5命令计算哈希值，校验是否一致

redefine的限制

  • 不允许新增加field/method

  • 正在跑的函数，没有退出不能生效，比如下面新增加的System.out.println，只有run()函数里的会生效

    1. public class MathGame {
    2.     public static void main(String[] args) throws InterruptedException {
    3.         MathGame game = new MathGame();
    4.         while (true) {
    5.             game.run();
    6.             TimeUnit.SECONDS.sleep(1);
    7.             // 这个不生效，因为代码一直跑在 while里
    8.             System.out.println("in loop");
    9.         }
    10.     }
    12.     public void run() throws InterruptedException {
    13.         // 这个生效，因为run()函数每次都可以完整结束
    14.         System.out.println("call run()");
    15.         try {
    16.             int number = random.nextInt();
    17.             List<Integer> primeFactors = primeFactors(number);
    18.             print(number, primeFactors);
    20.         } catch (Exception e) {
    21.             System.out.println(String.format("illegalArgumentCount:%3d, ", illegalArgumentCount) + e.getMessage());
    22.         }
    23.     }