Tomcat应用404问题排查与解决方案

1. 问题现象与初步排查最近在部署Java Web项目时遇到了一个典型问题Tomcat服务器能正常启动控制台没有报错日志但访问应用时却返回404状态码。这种服务器正常但应用404的情况在实际开发中相当常见今天我就结合自己踩过的坑系统梳理下各种可能的原因和对应的解决方案。首先确认几个基本现象Tomcat进程确实在运行通过ps -ef|grep tomcat或任务管理器确认控制台没有抛出ClassNotFound、ServletException等异常直接访问http://localhost:8080能显示Tomcat默认首页但访问具体应用路径如http://localhost:8080/myapp返回4042. 部署配置问题排查2.1 应用上下文路径配置最常见的原因是应用上下文路径(Context Path)配置错误。检查以下位置server.xml配置Context path/myapp docBasemyapp reloadabletrue/如果path属性配置为/访问时应该用http://localhost:8080/项目打包名称 WAR包名称直接决定默认上下文路径。比如myapp.war部署后默认路径就是/myappIDE部署设置 在Eclipse/IDEA中部署时注意检查Deployment选项卡下的Application context配置经验建议在开发环境保持上下文路径与生产环境一致避免环境差异导致问题2.2 部署目录检查通过Tomcat管理界面(http://localhost:8080/manager/html)确认应用是否真的部署成功显示的状态应该是Running而非Stopped物理路径检查确认webapps目录下存在应用目录解压后的文件夹或WAR包检查$CATALINA_BASE/conf/Catalina/localhost/下是否有对应的XML配置文件3. 应用内部问题排查3.1 web.xml配置检查重点检查welcome-file-list welcome-fileindex.html/welcome-file /welcome-file-list确保指定的欢迎文件实际存在于WEB-INF目录外如果有多个welcome-file会按顺序查找直到找到存在的文件3.2 资源路径问题静态资源404的常见原因路径中多了或少了个/资源文件没有放在正确位置WEB-INF外的资源才能直接访问使用了绝对路径而非相对路径调试技巧浏览器开发者工具查看Network请求的完整URL在JSP中使用${pageContext.request.contextPath}获取上下文路径4. 特殊场景排查4.1 多版本Tomcat冲突遇到过的情况系统安装了多个Tomcat实例环境变量CATALINA_HOME指向的与实际运行的不一致端口被其他服务占用解决方案# 查看实际运行的Tomcat路径 ps -ef | grep tomcat # 检查端口占用 netstat -tulnp | grep 80804.2 防火墙/安全组限制虽然Tomcat本地能访问但可能服务器防火墙拦截了外部请求云服务器的安全组未开放8080端口SELinux策略限制了网络访问检查命令# CentOS防火墙 firewall-cmd --list-ports # Ubuntu ufw ufw status5. 高级调试技巧5.1 日志级别调整修改conf/logging.propertiesorg.apache.catalina.core.ContainerBase.[Catalina].level FINE可以显示更详细的部署过程日志5.2 使用tcpdump抓包当怀疑请求未到达Tomcat时tcpdump -i any port 8080 -w tomcat.pcap用Wireshark分析抓包文件5.3 源码调试在IDEA中调试Tomcat源码下载对应版本的Tomcat源码在StandardHost、StandardContext等类中设置断点观察应用加载过程6. 典型问题速查表现象可能原因解决方案能访问/但无法访问/myapp上下文路径配置错误检查server.xml或war包名称静态资源404但JSP能访问资源路径错误使用开发者工具查看请求URL本地能访问但远程不能防火墙限制检查服务器防火墙和安全组偶尔出现404会话超时或应用重启检查Tomcat日志中的redeploy记录特定浏览器404缓存问题强制刷新或清除浏览器缓存7. 预防措施标准化部署流程使用Maven的tomcat7-maven-plugin统一部署编写自动化部署脚本健康检查机制实现/health接口返回应用状态使用Spring Boot Actuator日志规范化配置统一的日志格式关键操作添加DEBUG日志容器化部署FROM tomcat:9.0 COPY target/myapp.war /usr/local/tomcat/webapps/最后分享一个实用技巧在开发环境可以配置Tomcat的autodeployfalse和reloadablefalse这样修改代码后不会自动重新加载避免因部分类加载失败导致的诡异404问题。需要重启时再手动执行完整重启能减少很多中间状态问题。