如何将非Jar包内的外部文件添加至Spring Boot类路径资源

以下是几种实用的解决方案，适配不同场景：

1. 启动命令添加额外类路径 #

直接在启动Jar包时，将包含目标文件的目录追加到类路径中：

java -cp /path/to/your/file-directory:your-spring-boot-app.jar com.your.package.YourApplicationMainClass

之后在代码里就能用标准的类路径方式加载文件，比如通过ResourceLoader：

@Autowired
private ResourceLoader resourceLoader;

public void loadExternalFile() throws IOException {
    Resource resource = resourceLoader.getResource("classpath:your-target-file.ext");
    // 读取文件内容
    String content = Files.readString(Paths.get(resource.getURI()));
}

这种方式简单直接，适合临时调试或自定义部署场景。

2. 配置外部资源目录（生产环境推荐） #

在Jar包所在目录创建一个固定的外部资源目录（比如external-resources），然后通过以下方式加载：

• 直接通过相对路径加载：

public Resource loadExternalResource() {
    // 指向Jar同目录的external-resources子目录
    return new FileSystemResource("./external-resources/your-target-file.ext");
}

如果希望统一管理外部资源，也可以在启动类中注册自定义协议解析器，让Spring支持自定义前缀的资源加载：

@SpringBootApplication
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication app = new SpringApplication(YourApplication.class);
        DefaultResourceLoader resourceLoader = new DefaultResourceLoader();
        // 注册external协议，指向外部资源目录
        resourceLoader.addProtocolResolver((location, loader) -> {
            if (location.startsWith("external:")) {
                String filePath = location.substring(8);
                return new FileSystemResource("./external-resources/" + filePath);
            }
            return null;
        });
        app.setResourceLoader(resourceLoader);
        app.run(args);
    }
}

之后加载时就可以用external:your-target-file.ext的方式，无需关心具体路径。

3. 利用构建工具配置（开发阶段） #

如果是开发阶段需要频繁修改外部文件，可以在Maven/Gradle中配置额外的类路径目录：

• Maven：在pom.xml的build节点添加：

<build>
    <resources>
        <resource>
            <directory>${project.basedir}/external-resources</directory>
            <includes>
                <include>**/*.ext</include>
            </includes>
        </resource>
    </resources>
</build>

这样开发时IDE会自动把这个目录加入类路径，打包时可通过exclude配置不包含这些文件，部署时再把文件放到Jar同目录的对应位置。

注意事项 #

• 尽量使用相对路径而非绝对路径，避免部署时因环境不同导致路径失效；
• 若加载批量资源，可将整个目录加入类路径，而非单个文件；
• 确保应用进程对外部文件目录有读取权限。

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