Maven Web项目部署Heroku时web.xml无法识别映射触发404问题求助
找不到web.xml和404是直接关联的——web.xml是Servlet容器识别映射规则的核心配置,加载失败时所有自定义的Servlet、过滤器都不会生效,自然会返回404。首先要确认本地生成的WAR包内是否真的包含正确的web.xml,不要直接信任IntelliJ的exploded模式产物:
- 执行命令
jar tf target/你的项目WAR包名.war,或直接用解压软件打开WAR包,检查路径WEB-INF/web.xml是否存在、内容是否和源码一致。 - 如果WAR包内没有web.xml,问题完全出在Maven打包阶段,和Heroku部署无关。
1. Web源码目录不符合Maven规范
IntelliJ的exploded artifact会自动适配你手动指定的Web根目录,但maven-war-plugin默认只会扫描src/main/webapp作为Web资源根路径。如果你在创建项目时没有使用标准的maven-archetype-webapp原型,手动把web相关文件放在了非标准路径(比如项目根目录下的WEB-INF、src/main/resources下),打包时这些文件会直接被遗漏。
解决方法:
- 把所有Web相关文件(包括WEB-INF、静态资源、JSP、HTML等)迁移到
src/main/webapp/路径下,确保web.xml的最终源码路径为src/main/webapp/WEB-INF/web.xml。 - 同步修改IntelliJ的Web Facet配置,移除自定义的Web根目录路径。
2. 显式指定War插件的web.xml路径
如果web.xml路径已经符合规范,但打包后仍丢失,需要在maven-war-plugin配置中显式指定web.xml位置,开启缺失校验:
<plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-war-plugin</artifactId> <version>3.3.1</version> <configuration> <!-- 替换为你实际的web.xml源码路径 --> <webXml>src/main/webapp/WEB-INF/web.xml</webXml> <!-- 打包时如果找不到web.xml直接抛出错误,避免生成缺失文件的WAR包 --> <failOnMissingWebXml>true</failOnMissingWebXml> </configuration> </plugin>
针对heroku-maven-plugin部署方式
你当前的配置没有指定Web资源路径,导致插件无法自动识别web.xml位置,补充配置即可解决提示报错的问题:
<plugin> <groupId>com.heroku.sdk</groupId> <artifactId>heroku-maven-plugin</artifactId> <version>3.0.4</version> <configuration> <appName>app-name</appName> <warSourceDirectory>src/main/webapp</warSourceDirectory> <webXml>src/main/webapp/WEB-INF/web.xml</webXml> </configuration> </plugin>
针对Webapp Runner部署方式
如果WAR包已经确认包含正确的web.xml,但仍出现404,首先检查Procfile中的WAR包路径是否正确:
- Maven默认生成的WAR包命名规则是
项目artifactId-版本号.war,只有在POM中显式配置了<finalName>app-name</finalName>才会生成app-name.war。 - 检查Procfile中的WAR路径,确保和本地target目录下实际的WAR包文件名完全一致。
修复打包配置后,直接用webapp-runner在本地模拟Heroku环境运行WAR包,提前复现问题:
java -jar target/dependency/webapp-runner.jar --port 8080 target/你的实际WAR包名.war
如果本地用该方式运行同样报找不到web.xml、404,说明问题完全出在WAR包本身,继续排查打包配置即可,不需要考虑Heroku平台的差异。
内容的提问来源于stack exchange,提问作者Jane R

