Debian下Tomcat出现404错误怎么解决

Debian下Tomcat出现404错误的排查与修复

一、快速定位

• 确认服务与端口：执行sudo systemctl status tomcat9查看是否运行；用ss -tulpen | grep ':8080’或netstat -tuln | grep 8080确认端口监听。若端口被占用，修改**/etc/tomcat9/server.xml中Connector的port**并重启。
• 查看日志：优先检查**/var/log/tomcat9/catalina.out与localhost*.log**，从时间戳定位请求路径、应用名、Servlet映射与失败原因。
• 访问基线页面：先打开http://服务器IP:8080/与http://服务器IP:8080/manager/html（若已配置管理应用），以区分是“Tomcat未启动/端口问题”还是“应用未部署/路由问题”。
• 核对部署目录：进入**/var/lib/tomcat9/webapps/，确认应用目录或ROOT.war已存在且已解压，结构完整（含WEB-INF/web.xml**）。

二、常见原因与对应修复

• URL或上下文路径错误：Linux路径区分大小写，确认访问路径与app.war解压后的目录名一致；若部署为ROOT.war，根路径为**/，否则需带上下文路径（如/myapp**）。
• 应用未部署或WAR损坏：重新部署（清理webapps/应用名与work/Catalina/localhost/应用名后重启），或换用已知正常的WAR验证。
• Servlet或过滤器映射不匹配：检查应用的WEB-INF/web.xml或注解的url-pattern是否与请求路径匹配，避免拦截了静态资源或默认欢迎页。
• 默认欢迎页缺失：在应用的web.xml中添加欢迎文件（如index.html/index.jsp），或直接在URL中写明文件名。
• 文件权限不足：确保tomcat用户（或运行Tomcat的系统用户）对webapps/应用目录及子目录具备读取权限。
• 反向代理配置不当（如有Nginx/Apache）：核对proxy_pass指向的http://127.0.0.1:8080/正确上下文，以及Host头、路径前缀是否一致。
• 端口冲突或配置错误：server.xml语法错误、端口被占用都会导致访问异常；修正后重启Tomcat。

三、按场景的修复操作

• 访问应用根路径返回404：
  1. 确认webapps/ROOT/存在且包含可访问资源（如index.html）。
  2. 若希望部署到根上下文，将应用打包为ROOT.war并部署；或在server.xml的Host中配置Context path=“” docBase=“你的应用目录”（修改后重启）。
• 访问应用内页面404：
  1. 核对URL是否包含正确的上下文路径（如**/myapp/page**）。
  2. 检查WEB-INF/web.xml的servlet-mapping与welcome-file-list。
  3. 查看localhost*.log中对应的请求与映射结果，必要时调整映射或资源位置。
• 访问管理应用或示例页404：
  1. 在Debian上，管理应用默认可能未部署；如需使用，安装相应包（如tomcat9-admin），并在**/etc/tomcat9/tomcat-users.xml配置角色与用户后再访问/manager/html**。

四、验证与临时应对

• 验证：重启后依次访问http://IP:8080/与http://IP:8080/你的应用/你的页面，并再次查看catalina.out与localhost*.log确认无新的404记录。
• 临时应对（仅用于友好提示）：为某应用或全局配置自定义404错误页。示例：在应用的WEB-INF/web.xml中加入

  <
      error-page>
      
    <
      error-code>
      404<
      /error-code>
      
    <
      location>
      /error404.html<
      /location>
      
  <
      /error-page>
      
  

  并在webapps/应用/或webapps/ROOT/放置error404.html，然后重启Tomcat。注意这只是改善用户体验，仍需按上文定位根因。

声明：本文内容由网友自发贡献，本站不承担相应法律责任。对本内容有异议或投诉，请联系2913721942#qq.com核实处理，我们将尽快回复您，谢谢合作！