基于Kotlin的Spring Boot项目Gradle构建失败，无法生成可执行Fat Jar

看起来你遇到的问题大概率是构建脚本配置不完整或者版本兼容问题，我结合你给出的部分脚本，整理了一套可行的解决方案，帮你搞定Fat Jar打包：

首先，修正你的构建脚本 #

你的原始脚本缺少了关键的依赖管理插件、仓库配置，还有版本兼容细节，我给你整理了完整的Groovy风格build.gradle：

plugins {
    id 'org.springframework.boot' version '2.7.15' // 和Kotlin 1.2.21兼容的Spring Boot版本
    id 'io.spring.dependency-management' version '1.0.15.RELEASE'
    id 'java'
    id 'org.jetbrains.kotlin.jvm' version '1.2.21'
    id 'org.jetbrains.kotlin.plugin.spring' version '1.2.21'
}

group = 'myapp'
version = '1.0'

java {
    sourceCompatibility = '1.8' // Kotlin 1.2.x只支持到Java 8，必须对应上
}

repositories {
    mavenCentral() // 必须配置仓库才能拉取依赖
}

dependencies {
    // 核心Spring Boot Web依赖
    implementation 'org.springframework.boot:spring-boot-starter-web'
    // Kotlin对应Java 8的标准库
    implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk8"
    // Spring需要的Kotlin反射支持
    implementation "org.jetbrains.kotlin:kotlin-reflect"
    // 测试依赖
    testImplementation 'org.springframework.boot:spring-boot-starter-test'
}

// 配置Kotlin编译的JVM目标，和Java版本保持一致
tasks.withType(org.jetbrains.kotlin.gradle.tasks.KotlinCompile) {
    kotlinOptions {
        jvmTarget = '1.8'
    }
}

关键配置说明 #

• 插件声明优化：改用plugins块替代旧的apply plugin写法，Gradle会自动管理插件依赖，避免手动配置buildscript的繁琐
• 添加dependency-management插件：这个插件是Spring Boot打包的核心帮手，能自动统一所有Spring相关依赖的版本，彻底避免版本冲突
• 版本兼容配对：你用的Kotlin 1.2.21是较老版本，无法搭配Spring Boot 3.x（3.x要求Kotlin 1.7+），所以选择了2.7.15这个稳定的兼容版本
• Java版本对齐：Kotlin 1.2.x最高只支持Java 8，必须把sourceCompatibility和Kotlin编译的jvmTarget都设为1.8，否则编译会报错
• 必备Kotlin依赖：kotlin-stdlib-jdk8和kotlin-reflect是Kotlin Spring应用的标配，缺失会导致运行时出现找不到类的错误

操作步骤 #

1. 用上面的脚本替换你原来的build.gradle
2. 执行打包命令：
   • Mac/Linux：./gradlew bootJar
   • Windows：gradlew.bat bootJar
3. 打包完成后，Fat Jar文件会生成在build/libs/目录下，名称类似myapp-1.0.jar
4. 运行Jar包：java -jar build/libs/myapp-1.0.jar

排查技巧（如果仍有问题） #

• 查看构建日志的错误信息：如果是依赖冲突，执行./gradlew dependencies查看完整依赖树，找出重复或冲突的依赖
• 检查主类识别：如果你的Spring Boot主类不在默认包下，需要在脚本中添加springBoot.mainClass = '你的主类全路径'
• 避免插件重复声明：不要同时用apply plugin和plugins块声明同一个插件，会导致冲突

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