Spring Boot开发与打包运行时HTML页面加载路径不一致如何解决

Spring Boot可执行jar包的默认资源加载逻辑，本身就不识别src/main/webapp目录——这个目录是传统Java Web应用打war包部署到外部Tomcat等容器的标准资源目录，不属于Spring Boot内嵌容器运行jar包时的默认扫描路径。
本地执行mvn spring-boot:run时能读取到webapp下的文件，是spring-boot-maven-plugin在开发模式下的特殊处理：插件直接读取本地项目源码路径下的文件，没有走jar包内部的资源加载流程，属于开发态的特例，不是生产运行的标准行为，才会导致两种启动方式表现不一致。

方案1：统一禁用webapp目录加载（官方推荐，零兼容成本） #

该方案是Spring Boot官方推荐的标准做法，和生产jar包运行逻辑完全对齐：

• 将src/main/webapp下所有静态资源（HTML、JS、CSS等）迁移到src/main/resources/static目录；如果使用模板引擎渲染页面，将模板文件迁移到src/main/resources/templates目录
• 删除空的src/main/webapp目录
• 本地启动验证：执行mvn spring-boot:run时所有资源均从resources对应目录加载，不再依赖webapp目录，和java -jar启动的加载逻辑完全一致。

注意：如果项目使用JSP作为页面模板，Spring Boot内嵌容器本身存在硬限制，无法从可执行jar包中直接加载JSP文件。这种场景下如果要统一行为，只能统一打war包部署到外部Servlet容器，无法通过jar包运行方式支持JSP。

方案2：统一支持webapp目录加载（非官方推荐，仅适用于静态资源场景） #

如果确实需要保留src/main/webapp目录结构，可通过修改打包配置，让webapp下的资源在jar包运行时也能被识别，实现两边行为一致：

• 修改pom.xml中的maven资源插件配置，在打包阶段将src/main/webapp下的所有文件复制到jar包内的META-INF/resources路径下——该路径是Spring Boot内嵌容器默认识别的静态资源根目录，配置参考如下：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-resources-plugin</artifactId>
    <executions>
        <execution>
            <id>copy-webapp-to-resources</id>
            <phase>process-resources</phase>
            <goals>
                <goal>copy-resources</goal>
            </goals>
            <configuration>
                <outputDirectory>${project.build.outputDirectory}/META-INF/resources</outputDirectory>
                <resources>
                    <resource>
                        <directory>src/main/webapp</directory>
                    </resource>
                </resources>
            </configuration>
        </execution>
    </executions>
</plugin>

• 配置完成后重新打包，可解压jar包确认BOOT-INF/classes/META-INF/resources路径下存在原webapp目录的文件。此时无论本地用mvn spring-boot:run启动，还是服务器上用java -jar启动，都能正常读取webapp下的静态资源，行为一致。

注意：该方案依然无法支持JSP页面在可执行jar包中运行，仅对普通静态资源生效。

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