为何servletContext.getResourceAsStream能读取可执行Jar外的文件？

这事儿其实是Spring Boot为兼容传统Web项目开发体验做的特殊处理，再加上你可能在项目根目录运行Jar的场景，才导致了这个看似矛盾的现象，我给你拆解一下：

核心原因 #

1. JAR打包时src/main/webapp确实不会被包含
   这完全符合Spring Boot的文档规范——JAR打包的应用，静态资源应该放在src/main/resources/static、public、resources这些目录下，src/main/webapp是WAR打包的专属目录，默认会被构建工具（比如Maven）忽略，所以你在target的Jar里找不到这些资源是正常的。

2. 嵌入式Tomcat在特定场景下会加载文件系统中的src/main/webapp
   你遇到的“Jar运行时还能访问源目录资源”的情况，分两种场景：

   • 如果你用mvn spring-boot:run启动：Spring Boot Maven插件会自动把src/main/webapp添加到Tomcat的资源查找路径里，目的是让你开发时改完静态资源不用重新打包，刷新浏览器就能看到效果，这是开发模式的便利特性。
   • 如果你用java -jar启动但当前工作目录是项目根目录：这时候如果你的应用没改默认配置，或者不小心加了spring-boot-devtools依赖，devtools会自动把开发相关的路径（包括src/main/webapp）加入资源查找列表；另外，如果你手动配置了spring.resources.static-locations包含file:src/main/webapp/，也会出现这种情况。

   而servletContext.getRealPath("/")返回源目录路径，直接实锤了Tomcat正在用文件系统里的真实目录当文档根，而不是Jar包里的资源——毕竟Jar里的资源不是文件系统的真实文件，正常情况下getRealPath要么返回null，要么返回Tomcat临时解压的目录路径。

解决办法 #

根据你的需求，有两种处理方式：

方式一：迁移资源到标准目录（推荐） #

把src/main/webapp下的所有资源，移动到src/main/resources/static或者public目录下。这些是Spring Boot JAR打包应用的默认静态资源目录，构建工具会自动把它们打包进Jar，运行时无论是mvn spring-boot:run还是java -jar，都能正常访问，而且不会再依赖源目录的文件。

方式二：强制把src/main/webapp打包进Jar #

如果你必须保留src/main/webapp目录，可以通过配置spring-boot-maven-plugin，把这个目录的内容打包到Jar的META-INF/resources目录下（这是Servlet规范中静态资源的标准位置，Tomcat会自动识别）。修改你的pom.xml：

<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <configuration>
        <resources>
            <resource>
                <directory>src/main/webapp</directory>
                <targetPath>META-INF/resources</targetPath>
            </resource>
        </resources>
    </configuration>
</plugin>

这样打包后的Jar就会包含这些资源，运行时也不用依赖源目录了。

补充说明 #

Spring Boot官方文档明确提到：

当构建JAR包时，不要使用src/main/webapp目录——这个目录是WAR打包的标准目录，但如果生成JAR包，大多数构建工具会自动忽略它。

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