CentOS上Java日志出现错误代码的标准处置流程
一、快速定位与信息收集
- 明确日志来源与位置：应用日志通常在应用目录的logs/下，或配置文件中指定的路径；系统级服务日志用journalctl -u your-app.service查看；若应用异常退出，优先检查工作目录或**/tmp是否生成了hs_err_pid*.log**（JVM崩溃日志）。
- 查看与检索：使用cat /path/to/app.log | less、grep -n “ERROR” app.log、tail -n 200 app.log快速定位错误行与上下文。
- 同步收集环境信息：执行java -version、检查启动脚本的JAVA_HOME、工作目录与用户权限。
- 若日志配置疑似未生效，临时把日志级别调到DEBUG验证输出是否变化。
以上步骤可快速确定“哪里报错、报了什么、发生在哪个环境”。
二、常见错误代码与对应处置
| 错误现象或关键词 |
典型原因 |
快速处置 |
| OutOfMemoryError: Java heap space |
堆内存不足、对象生命周期或泄漏 |
先用jstat -gc 1000观察GC；必要时增加**-Xmx/-Xms**；导出堆转储jmap -dump:format=b,file=heap.hprof ，用MAT分析泄漏 |
| OutOfMemoryError: unable to create new native thread |
线程数超限或栈占用过大 |
降低**-Xss**；检查线程池与泄漏；在**/etc/security/limits.conf调高nofile/nproc** |
| OutOfMemoryError: Metaspace |
类元数据过多 |
增加**-XX:MaxMetaspaceSize**；排查热加载/动态生成类 |
| ClassNotFoundException / NoClassDefFoundError |
依赖缺失或打包问题 |
核对classpath、依赖版本与打包（fat jar）；确保运行用户与目录权限正确 |
| SQLException / Connection refused |
数据库配置、网络、服务状态 |
校验JDBC URL/账号/密码、网络连通与数据库是否可达 |
| Logback/Log4j 配置未生效 |
配置文件路径、类路径、格式错误 |
确认配置在classpath；先用DEBUG级别验证；修正logback.xml/log4j.properties语法与路径 |
| Permission denied / FileNotFoundException（写日志） |
日志目录无写权限 |
为运行用户授予目录写权限，例如chown -R appuser:appgroup /logs或chmod 755 /logs；避免使用777 |
| hs_err_pid.log 出现 SIGSEGV* |
JVM/本地库/JNI问题 |
分析崩溃日志的“Problematic frame”；升级JDK、移除有问题的本地库或改用纯Java实现 |
| 以上为最常见且高命中场景，先按现象归类再对症处理，可显著缩短恢复时间。 |
|
|
三、验证修复与上线
- 配置调整后先在测试环境验证，再滚动发布；重启服务（如systemctl restart your-app）并观察journalctl -u your-app与tail -f app.log的输出。
- 观察关键指标：GC频率与停顿（jstat）、线程状态（jstack）、磁盘与IO（df -h、iostat、iotop）。
- 建立日志轮转，防止磁盘被撑满：在**/etc/logrotate.d/your-app**中配置如
/var/log/your-app/*.log { daily missingok rotate 7 compress notifempty create 640 appuser appgroup }
- 保留hs_err_pid*.log与必要的heap dump，便于后续复盘与根因分析。
四、最小化排查命令清单
- 查看应用日志与错误：tail -n 200 app.log | grep -n “ERROR”
- 查看服务日志：journalctl -u your-app.service -b --since “10 minutes ago”
- 进程与线程：ps -ef | grep java；top -H -p ；printf ‘%x\n’ （转16进制用于jstack匹配）
- GC与内存：jstat -gc 1000；free -m；df -h
- 线程与锁：jstack | grep -A20 ；jstack | grep “java.lang.Thread.State” | sort -nr | uniq -c
- 崩溃与转储：cat hs_err_pid*.log；jmap -dump:format=b,file=heap.hprof
以上命令覆盖从“看日志”到“定位线程/内存/磁盘”的完整链路，适合作为现场排障的速查清单。