Jenkins执行Gradle命令任务无限运行问题求助及配置优先级咨询

GRADLE_OPTS优先级说明 #

Jenkins系统配置（Dashboard > Manage Jenkins > Configure System）中的GRADLE_OPTS是全局默认配置，而Jenkinsfile中定义的GRADLE_OPTS属于任务级局部配置——局部配置会直接覆盖全局配置。流水线任务执行时，会优先使用自身Jenkinsfile中设置的环境变量，全局配置的参数不会生效。

Gradle任务无限阻塞排查步骤 #

• 查看构建日志末尾输出：定位任务卡住前的最后操作，检查是否存在等待用户输入、依赖下载超时、资源锁竞争的提示。
• 检查EC2实例资源状态：执行top/htop命令，确认CPU、内存、磁盘IO是否被耗尽。若内存仍不足，说明GRADLE_OPTS参数未正确生效；若CPU持续满载，排查项目代码是否存在死循环；磁盘满会导致Gradle无法生成临时文件引发阻塞。
• 验证GRADLE_OPTS生效情况：在Jenkinsfile的Gradle任务前添加echo $GRADLE_OPTS命令，执行构建后查看输出，确认堆内存参数（如-Xmx、-Xms）是否正确应用。
• 本地复现任务：在EC2实例上以Jenkins用户身份手动运行gradle clean install --info，通过详细日志判断是项目自身问题（如依赖、代码）还是Jenkins环境问题。若本地也卡住，优先排查项目代码或依赖仓库；若本地正常，检查Jenkins代理权限、网络代理配置。
• 分析Java Melody监控数据：查看线程状态，定位处于WAITING/BLOCKED的线程；同时观察内存使用趋势，确认堆内存调整后是否仍存在溢出风险。
• 拆分任务逐步排查：先单独执行gradle clean，再依次执行gradle compile、gradle test、gradle assemble，定位具体阻塞的阶段（如测试用例死锁、打包资源冲突）。

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