Gradle技术问题：如何将资源文件添加至Spring应用Jar包根目录？

我懂你现在的困扰——用Gradle构建Spring Boot的server.jar时，原本想放到Jar根目录的资源，现在都跑到BOOT-INF/classes下面了，完全不符合预期的结构。别担心，调整下bootJar任务的配置就能搞定。

首先要明确：Spring Boot项目构建可执行Jar时，官方推荐用bootJar任务而非普通的jar任务，它能更好地适配Spring Boot的Jar结构规范。下面是针对你的需求的具体配置：

情况1：资源来自本地项目的src/main/resources #

bootJar {
    baseName = 'chessgame-server'
    version = '1.0.0'

    // 将指定资源复制到Jar根目录
    from('src/main/resources/your-target-resources') {
        into '' // 空字符串代表Jar的根目录层级
    }

    // 排除已移到根目录的资源，避免在BOOT-INF/classes中重复打包
    exclude('your-target-resources/**')
}

情况2：资源来自外部的资源Jar包（对应你提到的zipTree） #

bootJar {
    baseName = 'chessgame-server'
    version = '1.0.0'

    // 从外部资源Jar中提取指定内容到根目录
    from(zipTree('path/to/your/resources-library.jar')) {
        include('files-you-need/**') // 筛选你要提取的资源
        into ''
    }

    // 同样排除这些资源，防止重复出现在BOOT-INF/classes
    exclude('files-you-need/**')
}

核心要点解释： #

• into ''是关键：这个配置会把指定的资源直接放到Jar的根目录，而不是嵌套在任何子文件夹下。
• exclude不能少：如果不排除这些资源，它们会同时出现在Jar根目录和BOOT-INF/classes里，造成冗余。
• 用bootJar而非jar：普通jar任务生成的是标准Jar，而bootJar生成的是Spring Boot可执行Jar，结构更贴合框架要求。

配置完成后，执行./gradlew bootJar重新构建，生成的server.jar结构就会和你期望的一致——指定的资源文件乖乖待在Jar根目录，其他目录结构保持不变。

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