Tomcat日志中出现404错误怎么办

Tomcat日志出现404的排查与修复指南

一、快速判断与定位

• 查看 logs/catalina.out 与 logs/localhost.<日期>.log，定位出现 404 的 时间、客户端IP、请求URI、HTTP方法，确认是静态资源还是某个 Servlet/路径映射 不存在。
• 校验访问 URL：协议、主机、端口、应用上下文路径（如 /myapp）、Servlet 映射路径是否一致，注意大小写与斜杠。
• 确认应用是否已部署成功：进入 webapps，检查是否生成了应用目录或已解压的 WAR；若使用外部目录部署，核对 docBase 与目录实际存在。
• 核对端口连通：默认 8080，用浏览器或命令行访问 http://localhost:8080/ 验证 Tomcat 首页是否可达；必要时排查端口占用与防火墙。
• 若使用反向代理（如 Nginx/Apache），先绕过代理直接访问 Tomcat 验证，排除代理转发规则错误。

二、常见根因与对应修复

• 部署与WAR问题：WAR 损坏、未解压、应用名与访问路径不一致；重新打包并部署，确认 webapps/应用名/ 目录存在且内容完整。
• 上下文路径错误：应用实际上下文不是预期的 / 或 /myapp；检查 server.xml 的 或应用包名，必要时显式配置。
• 配置映射问题：web.xml 中 servlet-mapping 与访问路径不匹配；修正 url-pattern，并确保欢迎页（如 index.html/index.jsp）配置正确。
• 静态资源位置不当：应将资源放在 WebContent/static 或 src/main/webapp/static 等 Web 可访问目录，避免放在 WEB-INF 下（该目录受保护，浏览器不可直接访问）。
• 默认首页缺失：未在 web.xml 配置 welcome-file-list 或目录中缺少 index.html/index.jsp，导致根路径返回 404。
• 缓存与临时文件：清理 work/ 与 temp/，重启 Tomcat，避免旧编译结果干扰。
• 文件权限：确保运行 Tomcat 的用户对应用目录与文件具备读取权限。

三、Linux与网络层面的检查

• 端口占用与连通：使用命令检查 8080 是否被占用（如 netstat -tulnp | grep :8080 或 netstat -ano），必要时调整 server.xml 的 Connector port。
• 防火墙放行：在 CentOS/RHEL 执行
  sudo firewall-cmd --zone=public --add-port=8080/tcp --permanent
  sudo firewall-cmd --reload
• SELinux：若启用，检查是否限制 Tomcat 访问文件/端口，按需调整策略（如设置布尔值或文件上下文）。
• 代理配置：若经 Nginx 转发，核对 upstream、location 前缀与应用 context path 一致，避免路径被错误改写。

四、高效排查清单

五、日志解读示例与修复动作

• 日志示例：
  127.0.0.1 - - [20/Nov/2025:10:20:10 +0000] “GET /myapp/api/user HTTP/1.1” 404 961
  含义：访问 /myapp/api/user 返回 404。
  处理步骤：
  1. 在 webapps/myapp/WEB-INF/web.xml 检查是否存在匹配 /api/user 的 servlet-mapping；
  2. 若使用框架（如 Spring MVC），确认 @RequestMapping(“/api/user”) 生效且组件扫描正确；
  3. 确认应用已部署且 myapp 目录存在；
  4. 清理 work/ 并重启 Tomcat 后复测。