Tomcat日志中404错误原因分析

Tomcat 出现 404 的本质与快速判断 HTTP 404 表示客户端请求的资源在服务器上未找到。在 Tomcat 中，通常由资源不存在、部署结构不正确、URL 路径或映射错误、配置问题等引起。定位时优先查看 logs/catalina.out 与 logs/localhost.<日期>.log，从日志中的请求路径、应用名、状态码与异常堆栈快速锁定范围。

常见根因分类

资源与路径问题：请求的文件或页面在指定目录不存在或路径拼写错误；将文件直接放在 webapps 根目录 而非应用目录下，访问会 404；对 URL 大小写 敏感导致匹配失败。
部署与包问题：WAR 包损坏、未解压成功、应用名（上下文根）不正确；应用启动异常导致未就绪，访问任何资源都返回 404。
映射与配置问题：web.xml 中 Servlet/Filter 映射错误 或语法错误；server.xml 中 端口/上下文根 配置不当；错误的 SSL 端口/证书 配置引发访问异常，间接表现为 404。
访问控制与网络：目录访问被限制（如缺默认首页、权限不足）；防火墙/安全组 策略阻断访问，或容器/代理转发路径不一致。
缓存与客户端因素：浏览器或网关缓存了旧版本资源/路径，导致看似“已发布”的资源仍 404。

日志定位与排查步骤

在 logs/catalina.out 与 logs/localhost.<日期>.log 中检索 404 与请求 URL，确认请求的 应用上下文路径（Context Path）、Servlet 路径 与实际部署是否一致。
到 webapps 检查应用目录是否存在、是否已解压，WAR 是否完整；必要时清理并重新部署（删除应用目录与 work 下对应目录后重启）。
校验 URL 大小写与路径层级 是否与文件系统中的实际路径一致（如 /app/index.html 与 /App/index.html 不同）。
核对 web.xml 的 servlet-mapping、welcome-file-list 等配置是否正确；修正 server.xml 中的 端口/Context 配置并重启。
若使用 HTTPS/SSL，核对端口与证书配置是否正确，避免因握手或端口错误导致资源无法映射为 200。
排除访问控制与网络因素：确认目录允许访问、存在默认首页；临时关闭防火墙/安全组验证是否为网络阻断；如使用 Docker/反向代理，核对容器内路径与反向代理转发规则是否一致。
清理浏览器与网关缓存，或使用 curl -v 直接请求目标 URL，避免缓存干扰判断。

典型场景与修复建议

场景	日志与现象	修复建议
文件不在正确目录	访问 http://host:8080/index.html 报 404；文件实际在 webapps/ROOT/ 或本机其他路径	将文件放入应用目录（如 webapps/myapp/），用 http://host:8080/myapp/index.html 访问；不要将零散文件直接放在 webapps 根目录
应用未解压或 WAR 损坏	catalina.out 无应用启动日志；访问任何资源均 404	删除应用目录与 work/Catalina/localhost/；重新部署完整 WAR 并重启
URL 大小写或路径错误	访问 /App/Index 报 404，实际为 /app/index	按实际大小写与路径访问；统一前后端与反向代理的路径规范
web.xml 映射错误	访问 /hello 报 404；日志提示未找到对应 Servlet	修正 servlet-mapping 的 url-pattern，确保与请求路径一致
上下文根错误	部署为 myapp.war，却用 /app/ 访问	使用 /myapp/ 访问，或在 server.xml/Host 配置正确的 Context path
默认首页缺失	访问 / 报 404，目录存在但无 index.html	在 web.xml 配置 welcome-file-list 或放置 index.html
防火墙/安全组阻断	本机可访问，外部访问 404 或超时	临时关闭防火墙/安全组验证；放通 8080/8443 等端口
Docker/代理路径不一致	容器日志 200，外部 404；或反向代理转发前缀错误	核对容器内应用 Context Path 与代理 Location/ProxyPass 一致

最新问答

相关标签