本版本重点引入了堆内存诊断能力、MCP 文件查看工具、以及对 watch/trace 等核心命令的 ClassLoader 精准识别支持等多项重要更新。

? 新增功能 (Features)

1. vmtool 加入堆内存深度分析能力 (#1915, #3122)

致谢 @yuankong11

新增两大实用堆内存诊断操作：

heapAnalyze —— 全面评估堆内存使用状况

vmtool --action heapAnalyze --classNum 5 --objectNum 3

• 以 GC Root 为起点，遍历可达对象，统计各类型实例数及内存占用
• 按内存占比排序，展示占用最高的若干类与对象
• 支持 --classNum 控制类列表长度，--objectNum 控制对象列表长度

$ vmtool --action heapAnalyze --classNum 5 --objectNum 5class_number: 5367object_number: 140379id   #bytes     class_name----------------------------------------------------1    65552      byte[]2    65552      byte[]3    63024      byte[]4    61032      byte[]5    55736      byte[]id   #instances   #bytes          class_name----------------------------------------------------1    9052         7573224         byte[]2    26045        1721600         char[]3    3204         770376          java.lang.Object[]4    25810        619440          java.lang.String5    5376         605216          java.lang.Class

referenceAnalyze —— 追踪对象引用路径

vmtool --action referenceAnalyze --className java.lang.String --objectNum 5 --backtraceNum 3

• 针对指定类的实例，输出内存占用靠前的对象及其完整引用链（从目标对象逐级回溯至 GC Root）
• --backtraceNum 可设定回溯深度（-1 表示直达 root，0 表示仅显示对象不输出引用链）

`$ vmtool --action referenceAnalyze --className demo.MathGameid   #bytes     class_name & references----------------------------------------------------1    16         demo.MathGame 

2. watch/trace/stack/tt/monitor 命令支持 ClassLoader Hash 匹配 (#3120)

所有字节码增强类命令均扩展 -c/--classloader 参数，实现基于 ClassLoader 哈希值的精准增强：

sc -d com.example.Foowatch -c 3d4eac69 com.example.Foo bar '{params,returnObj}'trace -c 3d4eac69 com.example.Foo barstack -c 3d4eac69 com.example.Foo bar

• 有效规避同名类被多个 ClassLoader 加载时产生的增强冲突

• 建议先执行 sc -d 获取目标 ClassLoader 的哈希值，再通过 -c 显式指定

3. MCP 新增 viewfile 文件浏览工具 (#3121)

MCP Server 新增轻量级文件查看能力，适用于大文件分块读取场景：

• 支持 cursor/offset 分段加载机制，防止一次性返回超大数据阻塞响应

• 提供目录白名单配置（环境变量 ARTHAS_MCP_VIEWFILE_ALLOWED_DIRS）

• 默认开放目录：arthas-output、~/logs/

4. AnsiLog 输出流可定制化 (#3128)

• AnsiLog 不再强制绑定 System.out，现支持自定义输出流注入

• 便于统一日志管理、重定向或对接第三方日志系统

5. as-package.sh 新增 --f

ast 快速打包模式

构建脚本增加 --fast 参数，跳过部分非必要校验与优化步骤，显著缩短本地打包耗时。

? 缺陷修复 (Bug Fixes)

1. 修复 MCP 关闭状态下访问 arthas-output 导致的空指针异常 (#3127)

解决在禁用 MCP 功能时，尝试访问 arthas-output 目录引发 NullPointerException 的问题。

? 依赖升级 (Dependencies)

• 将 byte-buddy 升级至 1.18.3 版本

? 工程优化 (Engineering)

1. 新增 Telnet 连接终止泄漏集成测试 (#3125)

• 新增 telnet-stop-leak 测试模块

• 配套自动化测试脚本与 expect 脚本

• 同步接入 GitHub Actions CI 流水线

2. MCP 集成测试能力增强

• 补充 profiler 和 viewfile 工具的端到端集成验证

• 新增 ViewFileToolTest 单元测试用例

3. EnhancerTest 完善与扩展

• 修复原有 EnhancerTest 中存在的稳定性问题

• 新增覆盖 ClassLoader hash 增强逻辑的专项测试

源码获取：立即下载