深入解析oldratlee/useful-scripts中的Java诊断工具集

深入解析oldratlee/useful-scripts中的Java诊断工具集

useful-scripts 🐌 useful scripts for making developer's everyday life easier and happier, involved java, shell etc. 项目地址: https://gitcode.com/gh_mirrors/us/useful-scripts

前言

在Java应用开发和运维过程中，我们经常会遇到各种性能问题和类冲突问题。oldratlee/useful-scripts项目提供了一系列实用的Shell脚本，能够帮助开发者快速诊断和解决这些问题。本文将重点介绍其中的三个Java相关脚本：show-busy-java-threads、show-duplicate-java-classes和find-in-jars。

1. show-busy-java-threads：快速定位CPU高负载线程

1.1 脚本功能

show-busy-java-threads是一个用于快速排查Java应用CPU性能问题的脚本。它能自动找出运行中的Java进程里消耗CPU最多的线程，并打印出这些线程的堆栈信息，从而帮助开发者定位导致性能问题的方法调用。

1.2 使用场景

• 当Java应用CPU使用率异常高时
• 需要快速定位热点代码路径
• 排查线程死锁或资源竞争问题

1.3 使用方法

基本用法

show-busy-java-threads

这会自动从所有Java进程中找出最消耗CPU的线程（默认显示前5个线程）。

指定Java进程

show-busy-java-threads -p <pid>

高级选项

• -c <num>：指定显示的线程数量
• -a <file>：将输出追加到指定文件
• -S <dir>：指定存储中间文件的目录
• -s <path>：指定jstack命令路径
• -F：强制线程转储（当jstack无响应时）
• -m：显示本地方法栈帧
• -l：显示锁的附加信息

1.4 输出解读

脚本输出会显示每个高CPU线程的详细信息，包括：

• 线程名称和ID
• 线程状态
• 调用栈信息

通过这些信息，开发者可以快速定位到消耗CPU的代码位置。

1.5 实际案例

假设输出显示某个线程频繁执行java.text.DateFormat.format方法，那么可能需要：

1. 检查是否过度使用日期格式化
2. 考虑使用线程安全的日期格式化实例
3. 或者缓存格式化结果

2. show-duplicate-java-classes：查找重复类

2.1 脚本功能

show-duplicate-java-classes用于查找Java库（Jar文件）或类目录中的重复类。它支持全系统运行（Python 3实现），包括Linux、Mac和Windows平台。

2.2 使用场景

• 解决Jar冲突问题
• 预防NoSuchMethodError等类加载问题
• 构建时检查依赖冲突

2.3 使用方法

基本用法

show-duplicate-java-classes path/to/lib_dir

高级选项

• -L：递归搜索子目录中的Jar文件
• -J：搜索Jar中包含的Jar文件（处理FatJar场景）
• -c：指定类目录
• -R：不显示查找进度

2.4 典型应用场景

Maven项目

mvn dependency:copy-dependencies -DincludeScope=runtime
show-duplicate-java-classes target/dependency

Web项目（WAR）

unzip target/*.war -d target/war
show-duplicate-java-classes -c target/war/WEB-INF/classes target/war/WEB-INF/lib

Android项目

在build.gradle中添加任务：

task copyDependencies(type: Copy) {
    def dest = new File(buildDir, "dependencies")
    dest.deleteDir()
    dest.mkdirs()
    from configurations.compile into dest
}

然后运行：

./gradlew app:copyDependencies
show-duplicate-java-classes app/build/dependencies

2.5 输出解读

输出会显示：

1. 重复类的数量
2. 包含这些类的Jar文件
3. 具体的重复类列表

通过这些信息，开发者可以快速识别并解决依赖冲突问题。

3. find-in-jars：在Jar中查找资源

3.1 脚本功能

find-in-jars用于在当前目录下所有jar文件中查找类或资源文件。它支持Linux、Mac和Windows（通过cygwin或MSSYS）。

3.2 使用场景

• 查找特定配置文件的位置
• 检查某个类存在于哪些Jar中
• 排查类加载问题

3.3 使用方法

基本用法

find-in-jars 'log4j\.properties'

高级选项

• -d：指定查找目录
• -e：指定文件扩展名（默认jar）
• -a：使用绝对路径显示结果
• -s：指定分隔符
• -l：只列出包含匹配项的Jar文件

3.4 实际应用

# 查找所有包含log4j配置的Jar文件
find-in-jars -l 'log4j\.(properties|xml)$'

# 在指定目录中查找
find-in-jars 'SomeClass\.class' -d /path/to/lib

总结

oldratlee/useful-scripts中的这三个Java诊断脚本为开发者提供了强大的问题排查工具：

1. show-busy-java-threads：快速定位CPU热点
2. show-duplicate-java-classes：解决依赖冲突
3. find-in-jars：查找特定资源

这些脚本简单易用，无需复杂配置，是Java开发者工具箱中不可或缺的利器。通过合理使用这些工具，可以显著提高问题排查效率，缩短故障恢复时间。

useful-scripts 🐌 useful scripts for making developer's everyday life easier and happier, involved java, shell etc. 项目地址: https://gitcode.com/gh_mirrors/us/useful-scripts