java项目用gradle构建可执行胖jar的核心是使用shadow插件而非默认jar任务；需声明插件、指定mainclass、配置资源合并策略（如mergeservicefiles）、优化输出命名，并验证java -jar能否正常运行。
Java 项目用 Gradle 打超全胖 Jar（即包含所有依赖、主类可直接运行的单个 JAR），核心是用 Shadow Plugin，而不是 Gradle 自带的 `jar` 任务——后者默认不打包依赖，也不处理资源冲突或重复类。
1. 引入 Shadow 插件并启用
在 build.gradle（Groovy）中添加插件声明。推荐使用最新稳定版（如 8.7+），注意版本兼容 JDK 和 Gradle：
- Gradle 8.x 推荐用 Shadow
8.6.0+ - 插件声明方式统一用
plugins { id 'com.github.johnrengelman.shadow' version '8.7.0' } - 避免用旧式
apply plugin:写法，它不支持自动依赖解析
2. 配置主类与启动入口
胖 Jar 必须指定主类（Main-Class），否则 java -jar 会报错“no main manifest attribute”。在 shadowJar 块中设置：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
-
mainClass = 'com.example.Main'（类名必须完整，含包路径） - 也可用
manifest.attributes['Main-Class'] = 'com.example.Main'，效果相同 - 如果项目有多个启动类，建议显式指定，不要依赖
MANIFEST.MF自动生成
3. 处理依赖冲突与资源合并
多个依赖可能含同名文件（如 META-INF/MANIFEST.MF、logback.xml、module-info.class），直接打包会失败或覆盖。需配置 merge 策略：
- 用
mergeServiceFiles()合并META-INF/services/下的服务提供者配置 - 用
mergeContent()合并普通文本资源（如application.properties） - 对
META-INF/*.SF、META-INF/*.DSA等签名文件，加exclude 'META-INF/*.SF'避免冲突 - 若含模块化 JAR（有
module-info.class），建议exclude 'module-info.class'或用transform合并模块描述
4. 优化输出与命名（生产就绪）
生产环境要求 JAR 名清晰、无快照、带版本和时间戳（可选）：
- 设置
archiveBaseName.set('myapp')控制基础名 - 用
archiveVersion.set(project.version)，确保version = '1.2.3'在gradle.properties中定义 - 禁用快照后缀：
archiveClassifier.set('')（默认为all，可留空或设为prod） - 生成时附带 SHA256 校验：
doLast { ant.checksum(file: archiveFile.get().asFile, algorithm: 'sha256') }
不复杂但容易忽略：打完的胖 Jar 要验证是否真能运行——执行 java -jar build/libs/myapp-1.2.3.jar，看日志是否正常启动、端口是否监听、依赖类是否加载成功。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
