如何在GitLab CI中为Gradle Wrapper命令设置环境变量？

可能的原因及解决方法 #

1. 正确利用Gradle环境变量映射规则 #

Gradle会自动将前缀为ORG_GRADLE_PROJECT_的系统环境变量转换为project.properties中的属性。在GitLab CI中无需手动执行export，直接通过variables块定义即可：

Dev task:
  image: gradle:7.5.1-jdk11
  stage: dev-task
  variables:
    ORG_GRADLE_PROJECT_db_user: user1
    ORG_GRADLE_PROJECT_db_pwd: pwd1
  script:
    - ./gradlew -i dev_db_migration

此时你的build.gradle中通过project.properties['db_user']、project.properties['db_pwd']即可正常读取变量值。

2. 核对任务名称是否正确 #

你在Windows本地执行的是dev_task，但CI脚本中执行的是dev_db_migration，需确认该任务在项目中真实存在。可在CI脚本中先执行./gradlew tasks列出所有可用任务，验证名称准确性。

3. 排查Gradle配置覆盖问题 #

检查项目根目录的gradle.properties文件，若其中定义了同名的db_user或db_pwd属性，CI传递的变量会被本地配置覆盖，需删除或注释掉这些本地定义。

4. 调试变量读取状态 #

在build.gradle中添加调试代码，打印变量值辅助排查：

println "db_user from properties: ${project.properties['db_user']}"
println "db_user from env: ${System.getenv('ORG_GRADLE_PROJECT_db_user')}"

执行CI任务后查看日志，确认变量是否成功传递到Gradle环境中。

5. 使用GitLab CI/CD安全变量（推荐） #

如果是数据库密码这类敏感信息，不要直接写在.gitlab-ci.yml中，而是在GitLab项目的Settings -> CI/CD -> Variables中添加db_user和db_pwd变量（勾选"Protect variable"和"Mask variable"），再在CI脚本中映射：

Dev task:
  image: gradle:7.5.1-jdk11
  stage: dev-task
  variables:
    ORG_GRADLE_PROJECT_db_user: $db_user
    ORG_GRADLE_PROJECT_db_pwd: $db_pwd
  script:
    - ./gradlew -i dev_db_migration

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