You need to enable JavaScript to run this app. Maven Web项目部署Heroku时web.xml无法识别映射触发404问题求助
优惠活动
大模型
产品
解决方案
定价
更多

Maven Web项目部署Heroku时web.xml无法识别映射触发404问题求助

排查优先级:先确认WAR包本身完整性

找不到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部署的配置修正

针对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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.01 04:45:01