Debian Tomcat日志中的错误码含义解析

Debian Tomcat日志中的错误码含义解析

一 日志位置与快速定位

• 日志默认位于 $CATALINA_HOME/logs：核心输出为 catalina.out；按主机与应用的日志有 localhost..log、manager..log；访问日志（含客户端IP、请求URL、响应状态码）通常位于 localhost_access_log..txt。排查时优先查看 catalina.out 与 localhost 日志中的 ERROR/SEVERE/WARNING 及异常堆栈。命令行可用：tail -f、grep、less 等快速检索关键字（如“ERROR”“500”）。若需调整日志级别或输出路径，可编辑 conf/logging.properties。

二 HTTP状态码分类与含义

• 2xx 成功
  • 200：请求成功处理并返回内容
  • 204：成功但无内容返回
  • 206：范围请求成功
• 3xx 重定向
  • 301：永久重定向
  • 302：临时重定向
  • 303：重定向并要求使用 GET
  • 304：资源未修改，使用缓存
• 4xx 客户端错误
  • 400：请求语法错误或无法解析
  • 401：未认证
  • 403：已认证但无权限
  • 404：资源未找到
  • 405：请求方法不被允许
  • 406：不可接受的 Accept 类型
  • 408：请求超时
  • 409：请求与当前资源状态冲突
  • 410：资源已永久删除
  • 413：请求实体过大
  • 414：请求 URI 过长
  • 416：Range 请求无法满足
• 5xx 服务器错误
  • 500：服务器内部错误（应用异常/配置错误等）
  • 501：不支持请求所需功能
  • 502：网关/代理收到无效响应
  • 503：服务暂不可用（过载/维护）
  • 504：网关/代理等待后端超时
  • 505：不支持的 HTTP 版本 说明：Tomcat作为Servlet容器会原样返回或按配置映射上述HTTP状态码；访问日志中可直接看到这些状态码。

三 日志中常见异常与错误码对应

• 500 Internal Server Error
  • 含义：服务器处理请求时抛出未捕获异常或配置错误
  • 日志特征：catalina.out 或 localhost..log 出现堆栈，如 NullPointerException、数据库连接失败等
  • 排查要点：检查应用代码与依赖、配置（如 server.xml/web.xml）、数据库连通性与版本兼容、JDK版本匹配、磁盘/内存等资源
• 404 Not Found
  • 含义：无法找到请求资源
  • 日志特征：访问日志中状态码为 404；应用未部署或 web.xml 映射错误
  • 排查要点：确认应用已部署、上下文路径正确、静态资源存在、欢迎页配置无误
• 403 Forbidden
  • 含义：权限不足
  • 日志特征：访问日志中状态码为 403；安全约束或文件/目录权限不当
  • 排查要点：检查 web.xml 安全约束、操作系统文件权限与运行用户
• 401 Unauthorized / 407 Proxy Authentication Required
  • 含义：认证失败或需要代理认证
  • 日志特征：状态码 401/407；认证配置或凭据错误
  • 排查要点：核对认证方式（BASIC/FORM）、凭据与领域配置、反向代理认证头传递
• 400 Bad Request
  • 含义：请求报文语法错误或参数非法
  • 日志特征：状态码 400；常见于 JSON/XML 解析失败、Header/Content-Length 不合法
  • 排查要点：校验请求格式、长度与编码，查看解析器报错位置
• 502/504（常见于反向代理/网关前置）
  • 含义：网关从上游（Tomcat）收到无效响应或超时
  • 日志特征：访问日志中状态码 502/504；Tomcat 可能无对应请求日志
  • 排查要点：检查反向代理（如 Nginx/Apache）与 Tomcat 的网络、超时与负载；确认 Tomcat 进程存活与健康
• 503 Service Unavailable
  • 含义：服务暂不可用
  • 日志特征：状态码 503；Tomcat 关闭/过载/线程池耗尽
  • 排查要点：查看线程池与连接器配置、系统资源、应用启动失败原因
• NoClassDefFoundError / ClassNotFoundException
  • 含义：类缺失或依赖未加载
  • 日志特征：应用启动或请求时出现 NoClassDefFoundError
  • 排查要点：核对 WEB-INF/lib 依赖、依赖版本冲突、类加载器可见性
• OutOfMemoryError
  • 含义：内存不足
  • 日志特征：出现 java.lang.OutOfMemoryError
  • 排查要点：分析堆/元空间、优化内存与缓存、检查泄漏、适度扩容
• Address already in use（端口冲突）
  • 含义：配置的 HTTP/HTTPS/AJP 端口被占用
  • 日志特征：启动失败并提示端口被占用
  • 排查要点：使用 lsof -i:端口 或 ss -ltnp | grep 端口 查找占用进程并处理，或调整 server.xml 端口

四 快速排查命令与配置建议

• 定位与检索
  • 实时查看：tail -f $CATALINA_HOME/logs/catalina.out
  • 关键字过滤：grep -n “ERROR|SEVERE|500” $CATALINA_HOME/logs/localhost.log*
  • 访问日志分析：less $CATALINA_HOME/logs/localhost_access_log..txt（关注状态码与URL）
• 端口与进程
  • 查看占用：ss -ltnp | grep 8080 或 lsof -iTCP:8080 -sTCP:LISTEN
  • 释放端口：kill -9 PID（谨慎，先确认业务影响）
• 运行环境
  • 环境变量：echo $JAVA_HOME、$CATALINA_HOME；确保与部署版本匹配
• 日志与轮转
  • 动态调级：编辑 conf/logging.properties（如将级别调为 FINE/ALL 获取更多细节，注意磁盘占用）
  • 日志轮转：配置 logrotate 对 catalina.out 按日轮转、压缩与保留策略，避免单文件过大
• 重启验证
  • 变更后重启：sudo systemctl restart tomcat 或 $CATALINA_HOME/bin/catalina.sh stop/start（视你的部署方式而定）