CentOS Java运行时错误排查

CentOS Java运行时错误排查手册

一 快速定位流程

• 确认运行环境：执行java -version与（如需编译）javac -version，确保已安装且与程序兼容的 JDK/JRE；若未安装，使用包管理器安装 OpenJDK。
• 核对环境变量：检查JAVA_HOME是否指向 JDK 安装目录，PATH是否包含**$JAVA_HOME/bin**；必要时在**/etc/profile.d/java.sh**中统一设置并source使其生效。
• 复现与定位：保留完整错误输出与堆栈；若是脚本启动，在命令前加set -x或在 Java 命令前加bash -x观察展开过程。
• 查看应用日志：使用tail -f app.log或按关键字过滤grep “ERROR” app.log；若为容器/中间件，查看其标准输出与专名日志（如 Tomcat 的catalina.out）。
• 检查系统日志：用journalctl -n 100查看近期系统事件，或查**/var/log/messages**、/var/log/syslog中与 Java 相关的条目。
• 进程与资源：用ps -ef | grep java定位进程，top观察 CPU/内存，df -h检查磁盘空间，避免因资源不足导致异常。

二 常见错误与修复要点

三 深入诊断工具与方法

• 线程与死锁：用jps获取PID，执行jstack -l 查看线程栈与锁信息；必要时配合jconsole或VisualVM进行可视化分析。
• GC 与类加载：用jstat -gc 1000持续观察Eden/Survivor/Old区与 GC 次数/时间，判断是否存在内存压力或回收异常。
• 内存泄漏与 OOM：发生OutOfMemoryError时，用**jmap -dump:format=b,file=heap.hprof **导出堆转储，再用 Eclipse MAT 分析占用最多的对象与引用链。
• 系统层面：用top -H -p 定位高 CPU 线程，pidstat细化线程/进程资源；结合journalctl与**/var/log/**下的系统日志排查外部因素。

四 环境与配置检查清单

• 版本一致性：编译与运行的 Java 主次版本保持一致；避免跨大版本运行导致字节码不兼容。
• 环境变量：优先在**/etc/profile.d/java.sh统一设置JAVA_HOME与PATH**，避免用户级配置互相覆盖；修改后执行source /etc/profile.d/java.sh。
• 类路径策略：显式使用**-cp或-classpath**；依赖目录建议使用通配符**/path/to/libs/*，确保当前目录 .**与所有 JAR 均被包含。
• 权限与目录：确保运行用户对应用目录、日志目录与配置文件具备读/写/执行权限。
• 本地库与编码：若使用JNI或系统库，确认glibc等依赖满足；涉及中文显示时安装中文字体并更新字体缓存。

五 最小复现与求助模板

• 复现命令：提供可一键执行的命令，例如：
  java -Xms512m -Xmx1g -cp “.:/opt/app/lib/*” com.example.Main arg1 arg2
• 环境信息：
  java -version
  javac -version
  echo $JAVA_HOME
  echo $PATH
• 关键日志：
  tail -n 200 app.log | grep -i error
  journalctl -n 100 | tail -n 50
• 诊断附件：发生崩溃时附上hs_err_pid*.log；出现 OOM 时附上heap.hprof（注意脱敏）。
• 说明：描述触发步骤、期望结果与实际结果、复现频率与最近变更（代码/依赖/系统/网络）。