IntelliJ IDEA中通过Tomcat运行Spring应用返回404如何解决

核心问题原因 #

你遇到的404报错本质是IDEA部署过程中Spring Boot应用没有被正确初始化启动，Tomcat只是完成了空的Web目录部署，没有可处理请求的Spring服务进程，所以访问根路径返回404。

补充疑问解答 #

只要Spring Boot上下文正常初始化，一定会输出标志性的启动logo、端口、初始化耗时等日志，没有输出就说明Spring Boot的启动流程完全没有执行，和你的判断一致，确实是部署环节存在问题。

你打包成ROOT.war放入外部Tomcat运行正常，说明项目本身的Spring Boot配置、外部Tomcat适配都是正确的，问题仅出在IDEA的本地运行配置上，可按以下优先级排查修复：

修复方案 #

1. 修正部署上下文路径 #

你需要将应用部署到根路径，需先调整IDEA的Tomcat部署配置：

• 打开Tomcat运行配置，切换到「Deployment」标签页
• 找到你部署的myappname:war exploded项，将对应的「Application context」值修改为/，注意不要留空也不要填写其他路径
• 保存配置后重启服务即可

2. 检查war exploded包的依赖完整性 #

IDEA的exploded部署模式默认可能不会自动把所有依赖打入部署包，导致Spring Boot启动失败：

• 打开IDEA项目结构面板（快捷键Ctrl+Alt+Shift+S），进入「Artifacts」标签
• 找到你部署的myappname:war exploded项，检查右侧Output Layout下的WEB-INF/lib目录是否包含所有项目依赖的jar包
• 如果有缺失，右键点击左侧「Available Elements」列表里的所有项目依赖，选择「Put into WEB-INF/lib」，保存配置后重新部署即可

3. 清理Tomcat缓存并重置配置 #

如果上面两步操作后仍无Spring启动日志：

• 打开Tomcat运行配置的「Server」标签页，取消勾选「Deploy applications configured in Tomcat instance」，避免本地Tomcat自带的应用干扰
• 进入IDEA的系统缓存目录，删除对应Tomcat实例的缓存文件夹，路径参考你日志里的C:\Users\Main\AppData\Local\JetBrains\IntelliJIdea2021.2\tomcat\f74e8856-a9b4-4e50-9d59-c901731f3dc7，直接删除整个文件夹后重启IDEA重新部署即可

操作完成后启动服务，控制台会输出Spring Boot启动logo，此时访问localhost:8080即可正常访问应用。

内容的提问来源于stack exchange，提问作者KunLun