使用 Arthas 精准排查 SpringBoot 多模块项目中未使用的类（安全清理无用代码）

使用 开源 Java 诊断工具 Arthas ，通过 运行时类加载分析 ，100% 精准定位 SpringBoot 多模块项目中从未被使用的类，实现安全、无风险的代码清理。

一、为什么选择 Arthas？

1. 运行时精准检测：只统计项目启动后实际被 JVM 加载的类，规避静态检测的误判问题；
2. 适配多模块项目：完美支持微服务、多模块聚合工程，无需修改源码、无需引入 Maven 插件；
3. 零侵入、无风险：不修改项目代码、不影响运行环境，测试 / 生产环境均可使用；
4. 彻底解决盲区：能识别 MyBatis Mapper、动态注入 Bean、反射调用类，杜绝误删。

前置准备

1. 已启动 SpringBoot 多模块项目（本地 / 测试环境均可）；
2. 安装 curl（Mac/Linux 自带）；
3. 打开项目 根目录 的命令行终端。

二、实战步骤

步骤 1：下载并启动 Arthas

在命令行执行一键命令，自动下载并连接 SpringBoot 进程：

curl -O https://arthas.aliyun.com/arthas-boot.jar && java -jar arthas-boot.jar

执行后输入项目进程序号，回车即可进入 Arthas 控制台。

步骤 2：导出项目「运行时已加载的业务类」

核心命令：仅扫描自定义包路径，过滤 JDK 系统类，直接导出到文件：

sc xx.xxx.xxxx.* > loaded_classes.txt

• sc：Arthas 查看 JVM 已加载类的命令；
• xx.xxx.xxxx.*：替换为 项目的根包路径 ；
• loaded_classes.txt：运行时真正被使用的类清单。

步骤 3：导出多模块项目「所有 Java 类」

在项目根目录执行命令，自动扫描所有模块下的业务代码：

find . -name "*.java" -path "*/src/main/java/*" > all_classes.txt

步骤 4：格式转换（统一类名格式，用于对比）

将文件路径转换为 Java 全类名（包名。类名）：

cat all_classes.txt | sed -E 's/.*src/main/java///g' | sed -E 's/.java$//g' | tr / . > all_classes_fullname.txt

步骤 5：对比生成「未使用类清单」

执行命令，筛选出项目存在、但运行时从未加载的类：

grep -v -x -f loaded_classes.txt all_classes_fullname.txt > unused_classes.txt

打开 unused_classes.txt，里面的类就是可清理的冗余类。

三、安全删除规范（必看，杜绝删崩项目）

即使工具检测为未使用，删除前必须遵循以下规则，保证 100% 安全：

1. 排除带 Spring 注解的类：@Service/@Component/@Controller/@Configuration 等；
2. 排除数据相关类：Entity、DTO、VO、Mapper、枚举、常量类；
3. 排除配置文件引用类：application.yml 中配置的类；
4. IDEA 安全删除：右键类 → Safe Delete，二次确认无引用后删除；
5. 验证：删除后重启项目，执行接口 / 单元测试，无报错则完成清理。

四、使用脚本再排查一遍import的地方

# 输出文件 outfile="final_unused_classes.txt" rm -f $outfile touch $outfile # 逐行检查 while IFS= read -r cls; do [[ -z "$cls" ]] && continue echo "==================================================" echo "正在检查 → $cls" # 1. 检查是否有 import 完全匹配 has_import=$(grep -r "import $cls;" . --include="*.java" 2>/dev/null | wc -l) # 2. 检查是否有全类名使用（包名.类名） has_full_use=$(grep -r "b$clsb" . --include="*.java" 2>/dev/null | grep -v import | wc -l) # 3. 只有 完全没有 import + 完全没有全类名使用 → 才算真无用 if [[ $has_import -eq 0 && $has_full_use -eq 0 ]]; then echo " 真·无引用 → 可删除" echo "$cls" >> $outfile else echo " 存在引用 → 不删除" fi done < "unused_classes.txt" echo " ==================================================" echo " 检查完成！安全可删除的类已保存到：final_unused_classes.txt"