Tomcat日志中 HTTP 500 错误的定位与处理
一、快速定位步骤
- 查看关键日志：优先检查 catalina.out（标准输出/错误）、localhost.<日期>.log（应用部署上下文日志）、以及应用自身的日志（如 Spring Boot 的 spring.log）。在日志中搜索关键字 HTTP 500、SEVERE、ERROR、异常堆栈（如 NullPointerException、SQLException）。
- 复现并最小化：用 curl -v 或 Postman 复现问题，尽量用最简请求（如仅访问某个 Servlet 或最小化参数），排除业务链路干扰。
- 关联时间与实例：确认错误发生的 时间点、请求路径、线程名/请求ID，在多实例/负载均衡下定位到具体 Tomcat 实例。
- 临时提高日志级别：在 logging.properties 中临时将相关 logger 调到 FINE/DEBUG，获取更详细的调用栈与参数信息（问题定位后记得恢复）。
- 校验部署产物：确认 WAR 已完整解压、最新版本已生效，避免加载到旧类或旧配置。
以上步骤依赖对 catalina.out、localhost.log 等日志的查看与分析，是定位 HTTP 500 的首要环节。
二、常见根因与对应修复
- 代码缺陷与未捕获异常：如 空指针、数组越界、业务异常未处理。修复方式：阅读堆栈定位到具体类与方法，补充判空/边界检查与异常处理，必要时增加日志。
- 配置错误：server.xml、web.xml、Context 配置不当（如 Context Path、端口、过滤器/监听器配置错误）。修复方式：逐项核对配置与部署描述符，修正错误的路径、参数与启动顺序。
- 资源限制：内存不足（OOM）、CPU飙升、磁盘满。修复方式：监控资源使用，适当调大 JVM 堆内存（如 -Xms/-Xmx）、清理磁盘、优化慢查询/慢接口。
- 数据库连接与连接池：连接 URL/账号/密码 错误、数据库宕机、连接池耗尽。修复方式：验证数据库可达性与凭据，检查连接池参数（最大连接数、超时），确保数据库服务正常。
- 版本不兼容：JDK 与 Tomcat 版本不匹配、编译与运行 JDK 不一致导致 UnsupportedClassVersionError。修复方式：统一 JDK 主版本 与 位数（32/64 位），必要时用编译时的 JDK 重新编译。
- 文件权限与路径：Tomcat 对 WAR、配置文件、临时目录 无读写权限或路径不存在。修复方式：授予运行用户相应权限，确认目录存在并可写。
- 外部依赖故障：依赖的 缓存/消息/第三方 API 不可用。修复方式：检查依赖服务健康状态与网络连通性。
- 网络问题：请求未达或响应未回（如 负载均衡/防火墙/NAT 异常）。修复方式：排查网络链路、超时与重试策略。
- 大文件上传限制：默认 multipart 限制（如 50MB）导致上传失败触发 500。修复方式：在 web.xml 的 中调大 max-file-size / max-request-size（如改为 100MB），并重启。
- WAR 过大或解压失败：部署 大体积 WAR 时易卡死或失败。修复方式：分拆包、增大 JVM 堆、使用外部存储或优化构建产物。
以上为 HTTP 500 的高频根因与处置要点，可结合日志逐一排查与修复。
三、典型日志与修复示例
- 示例 1：JDK 版本不匹配
日志特征：出现 UnsupportedClassVersionError。
处理：统一 JDK 主版本 与 位数，用与编译时一致的 JDK 重新编译，或升级 Tomcat 至支持该 class 文件版本 的版本。
- 示例 2：数据库连接失败
日志特征：出现 SQLException/CommunicationsException，无法获取连接或认证失败。
处理：核对 JDBC URL、用户名、密码，确认 数据库服务 运行且网络可达，检查连接池配置与超时。
- 示例 3：大文件上传被拒
日志特征：FileUploadBase$SizeLimitExceededException，提示上传大小超过配置上限（如 52428800 bytes ≈ 50MB）。
处理：在 web.xml 的 中调大 max-file-size / max-request-size（如 104857600 bytes ≈ 100MB），重启生效。
- 示例 4：静态资源正常但业务接口 500
日志特征：localhost.<日期>.log 中业务堆栈明显，数据库或缓存异常。
处理：优先恢复依赖服务（数据库/缓存），再修复应用侧异常与重试/降级策略。
以上示例覆盖了 版本不匹配、数据库、上传限制 与 业务异常 等常见场景，可直接对照日志快速处置。
四、临时缓解与长期优化
- 临时缓解：回滚到上一个稳定版本；对异常接口做 熔断/降级/限流；临时调大 JVM 堆 与 连接池；对大文件场景临时放宽 multipart 限制并控制并发上传。
- 长期优化：完善 日志与监控告警（异常率、响应时延、数据库连接数、磁盘/内存）；建立 灰度发布与回滚 机制；规范 依赖与版本管理，避免不兼容升级；对 SQL 与 外部调用 增加超时与重试，关键路径加 幂等 与 降级。
