javOSize 深度调研一个 jar 包搞定 Java 线上性能分析与热更新java -jar javosize.jar pid回车之后你的线上应用就多了一个外挂终端能看线程、能查内存泄漏、能给任意类的任意方法插代码甚至用 vi 改完源码保存的瞬间就完成热更新——这就是 javOSize官方口号叫你的咖啡杯中缺少的那颗糖。本文基于对 javosize.jar 本体的逆向分析 实测整理把它的使用方式、热更新脚本和适用场景一次讲透。一、javOSize 是什么javOSize 是一款Java 在线诊断与热更新工具整个工具就是一个约 5MB 的javosize.jar无需安装配置。它通过 JVM 的Attach Instrumentationredefine/retransform机制挂载到运行中的 Java 进程提供线程 / CPU / 内存实时分析类浏览、反编译、在线热更新方法级拦截类 AOP 的代码注入断点调试支持远程断点内存泄漏检测、慢方法定位免重启开启 JMX / GC 日志自定义指标上报InfluxDB、定时任务调度从 jar 包的 MANIFEST 可以确认它的双重身份Premain-Class: com.javosize.agent.Agent - 支持 -javaagent 启动前挂载 Agent-Class: com.javosize.agent.Agent - 支持 Attach 运行时挂载 Can-Redefine-Classes: true - 具备热替换能力 Can-Retransform-Classes: true Main-Class: com.javosize.cli.Main - 独立 CLI 入口它的设计哲学和传统 ProfilerJProfiler、YourKit完全不同不是监控面板而是一个文件系统风格的交互式 Shell——所有能力都组织成目录用ls浏览、cd进入、cat查看、vi编辑、exec执行。上手成本几乎为零。二、快速上手三步挂载到目标进程2.1 启动# 1. 找到目标 Java 进程 pid ps aux | grep java # 2. 一行命令挂载目标机器需要有 JDKjavOSize 的部分命令依赖 JDK 编译能力 java -jar javosize.jar pid完整启动参数java -jar javOSize.jar [-entity实体 -command命令] # 非交互式单命令执行 [-port监听端口] # 开启远程访问端口 [-b] # 后台模式 [-waitForConnections] # 等待远程客户端 [PID]挂载成功后进入交互式控制台输入ls就能看到根目录下的各个实体目录。2.2 目录即功能javOSize 的核心隐喻是一切皆目录常用目录如下目录功能THREADS线程列表、线程栈、CPU 占用、杀线程CLASSES浏览已加载类、反编译、在线编辑热更INTERCEPTOR给任意方法注入拦截代码AOP 式BREAKPOINTS运行时断点捕获现场PROBLEMS自动检测死锁、频繁 GC 等问题REPOSITORY内置脚本仓库内存泄漏检测、开 JMX 等JMX浏览/操作 MBeanSESSIONSWeb 会话追踪统计通用命令ls、cd、cat、grep、vi、exec、man cmd帮助、exit。每个目录下执行help可查看该目录支持的专属命令。三、核心功能详解与实操3.1 性能分析三板斧① 问题自动检测PROBLEMS进入PROBLEMS目录执行lsjavOSize 会自动给出健康检查结果Concurrency Deadlocked: false # 是否死锁 Memory High GC (2%): false # GC 时间占比是否过高排查CPU 飙高接口突然变慢时先来这里看一眼几秒钟排除死锁和 GC 风暴。② 慢方法定位FindSlowMethodsjar 内置了FindSlowMethodsAction可以按包名过滤统计最耗时的方法相当于轻量级方法级 Profiler不用像 BTrace 那样先写追踪脚本。③ 线程分析THREADScd THREADS ls # 列出所有线程及 CPU 占用 cat thread-id # 查看指定线程堆栈 kill thread-id # 强制结束某个失控线程慎用配合THREADDUMP命令可以直接拿到完整线程转储。3.2 内存泄漏检测进入REPOSITORY目录一条命令找出指定包下占用内存最大的静态变量cd REPOSITORY exec TOP_FAT_STATIC_VARIABLES 5 com.apache.*输出占用最大的 5 个类及其静态变量大小。静态集合持有对象是 Java 内存泄漏最常见的根源这个命令直击要害比导 heap dump 再用 MAT 分析快得多适合快速初筛深度分析仍建议 MAT。3.3 免重启开启 JMX 和 GC 日志运维场景神器——应用启动时忘了开 JMX不用重启cd REPOSITORY exec START_JMX_SERVER 6666 # 在 6666 端口开启 JMX Server cd JMX exec java.lang:typeMemory.setVerbose(true); # 动态打开 GC 日志3.4 方法拦截给线上代码打日志这是 javOSize 最有想象力的功能。进入INTERCEPTOR目录可以给任意类的任意方法注入一段代码方法前后执行效果类似动态 AOPcd INTERCEPTOR create TickServlet begin mypackage.Hello doGet System.out.println(Servlet invoked);上面这条命令的含义给mypackage.Hello类的doGet方法开头begin也支持end注入一行打印语句。立即生效无需重启用于线上临时加日志排查问题非常高效删除拦截器即可完全还原字节码。四、重点线上热更新全流程javOSize 的热更新建立在 JVM Instrumentation 的retransformClasses之上并内置了内存编译器InMemoryJavaCompiler和HotSwapper把改代码→编译→替换压缩成了一次保存动作。方式一vi 编辑即热更最快cd CLASSES ls | grep Hello # 找到目标类 vi mypackage.Hello # 直接在 vi 中编辑反编译出来的源码 :wq # 保存瞬间自动编译 - retransform - 生效保存后 javOSize 在内存中完成编译并热替换该类下一次调用就走新逻辑了。方式二非交互式热更脚本适合自动化利用-entity/-command参数可以把热更做成 shell 脚本比如把本地修改好的类文件批量替换#!/bin/bash # hotswap.sh —— 线上热更脚本示例 PID$1 CLASS_NAME$2 # 1. 用本地已编译好的 class 通过 redefine 替换对应内置的 RedefineClassFromByteCode 能力 java -jar javosize.jar -entityCLASSES -commandredefine $CLASS_NAME /path/to/${CLASS_NAME}.class $PID # 2. 验证cat 反编译确认新逻辑已加载 java -jar javosize.jar -entityCLASSES -commandcat $CLASS_NAME $PID执行./hotswap.sh 12345 mypackage.Hellojar 中还提供了RedefineClassFromJarFileAction支持直接从本地补丁 jar 中批量替换多个类适合小范围紧急修复。方式三断点现场修改复杂问题对于需要看运行时数据的场景先加断点冻结请求线程检查变量后再决定如何修改javOSize 支持BREAKPOINTS和远程断点RemoteBreakPoint可以在断点处执行自定义代码。热更新的边界必读无论哪种方式都受 JVM HotSwap 限制✅ 可以修改方法体内部逻辑❌ 不行增删字段、增删方法、改变方法签名、修改类继承结构除非目标 JVM 打了 DCEVM 补丁⚠️ 重启后失效热更是内存级的不会改动磁盘上的 class 文件修复必须同步回代码仓库否则下次发布就打回原形五、进阶玩法5.1 远程模式与 Web 控制台生产环境往往无法直接 SSH 到目标机javOSize 提供了 C/S 架构# 目标机后台模式启动并监听端口 java -jar javosize.jar pid -port3113 -b -waitForConnections # 本地机连接远端 java -jar javosize.jar -port3113 remote-hostjar 中还包含javosizeweb包提供基于 Web 的控制台浏览器里完成诊断操作。5.2 定时任务与指标上报内置 Scheduler 支持调度诊断脚本定时执行如每天凌晨跑一次内存 Top 统计Metrics 模块支持自定义指标并通过内置的 InfluxDB 平台适配器持续上报把它当作轻量级 APM 用也可以。六、横向对比javOSize vs Arthas vs BTrace维度javOSizeArthasBTrace出品方/时间西班牙团队约 2015阿里巴巴2018 开源Oracle 社区2008接入方式单 jarAttach 即用arthas-boot 脚本安装编写 Java 追踪脚本交互模型文件系统式 Shellls/cd/vi命令行 REPL脚本一次性注入热更新vi 保存即热更内置内存编译器jadmcredefine 三段式不支持只做追踪方法拦截create 拦截器一行命令watch/trace/tt 更强大安全脚本语法功能强但门槛高断点支持含远程断点不支持不支持生态维护官网已下线基本停更活跃37k Star持续发版低频维护JDK 兼容JDK 6~8 时代产物高版本兼容性差JDK 8~25 全支持较好选型结论javOSize 的vi 即热更体验至今仍是最顺滑的作为老项目的趁手工具值得收藏但对新项目尤其是 JDK 11/17/21 环境首选 Arthas——它吸收了 javOSize/Greys/BTrace 的经验且社区活跃。javOSize 更适合作为理解Java Agent 字节码热替换原理的教学样本。七、风险提示与最佳实践生产环境是双刃剑字节码注入有侵入性误操作可能直接影响线上流量。热更前务必在测试环境演练权限收敛exec支持执行系统命令、vi可改任何类等于给操作者开了上帝模式务必做好登录审计与权限管控热更要闭环线上热修只是止血代码必须同步提交仓库走正式发布避免热更版本漂移事故注意 JDK 版本本工具诞生于 JDK 6~8 时代在新版 JDK模块化以后上 Attach 可能失败建议用于存量 JDK 8 应用诊断完及时退出拦截器和增强字节码有额外性能开销排查完毕删除拦截器、退出 agent 让类恢复原状。八、总结javOSize 用一个 jar 包证明了Java 线上诊断可以像操作本地文件系统一样简单。它把 Attach API、Instrumentation、内存编译、断点注入这些底层技术封装成了ls/cd/cat/vi四个动词其中 vi 保存即热更新 的设计即使放在今天也不过时。虽然项目已停止维护、不建议引入新技术栈但如果你还在维护 JDK 8 的存量系统或者想深入学习 Java Agent 字节码热替换原理javOSize 都是一颗值得一尝的糖。参考链接-javOSize 官方介绍存档http://www.javosize.com/-CSDN《javOSize: 新一代 java 分析工具》https://blog.csdn.net/skiof007/article/details/51966295-Stack Overflow 相关讨论https://stackoverflow.com/questions/31413112-同类工具 Arthashttps://github.com/alibaba/arthas