macOS下Docker部署Jenkins构建Android项目失败：缺失google-service.json

你遇到的是Android构建里很常见的配置文件缺失问题——google-service.json包含Firebase或Google Mobile Services的敏感配置，出于安全考虑通常不会提交到Git仓库，所以Jenkins拉取代码后找不到它就会触发构建失败。结合你用Docker部署Jenkins的场景，这里有几个实用的解决方案：

方案1：用Jenkins凭证管理生成配置文件（最安全） #

这种方式能避免敏感文件暴露在本地或容器中：

• 打开Jenkins后台，进入「Credentials」→「系统」→「全局凭据」，点击「添加凭据」
• 选择「Secret text」类型，把本地google-service.json的完整内容粘贴到「Secret」输入框，设置一个好记的ID（比如GOOGLE_SERVICE_JSON）后保存
• 在你的Jenkins构建步骤（或Jenkinsfile）里添加shell命令：

  echo "${GOOGLE_SERVICE_JSON}" > app/google-service.json
  

  注意：路径app/google-service.json要和你Android项目里该文件的预期位置一致，若项目结构不同需调整路径。

方案2：挂载本地配置文件到Docker容器 #

既然你已经挂载了Android SDK和Jenkins数据卷，可以直接把本地的google-service.json挂载到Jenkins工作目录的对应位置：

• 修改你的Docker启动命令，添加一个新的挂载参数：

  docker run -p 8080:8080 \
    -v /Users/foo/bar/Android/sdk:/var/android_home \
    -v /Users/foo/bar/google-service.json:/var/jenkins_home/workspace/[你的Jenkins项目名]/app/google-service.json \
    -p 50000:50000 \
    -v jenkins_home:/var/jenkins_home \
    jenkins/jenkins:lts
  

  记得把[你的Jenkins项目名]替换成你在Jenkins里创建的项目实际名称，容器启动后，Jenkins工作目录里就会自动出现这个配置文件。
• 额外注意：确保本地的google-service.json权限正确，Jenkins容器内的jenkins用户能读取它，可执行chmod 644 /Users/foo/bar/google-service.json调整权限。

方案3：通过Gradle环境变量动态生成（需项目支持） #

如果你的Android项目build.gradle已配置从环境变量读取配置的逻辑，可以直接在Jenkins里设置环境变量：

• 在Jenkins项目的「构建环境」里勾选「Set environment variables」，添加变量（比如GOOGLE_SERVICE_JSON_CONTENT），值为配置文件的完整内容
• 在app/build.gradle里添加逻辑，把环境变量内容写入文件：

  task generateGoogleServicesJson {
      doLast {
          file("google-service.json").text = System.getenv("GOOGLE_SERVICE_JSON_CONTENT")
      }
  }
  preBuild.dependsOn generateGoogleServicesJson
  

  这样构建前会自动生成配置文件。

重要提醒 #

绝对不要把google-service.json提交到Git仓库，这个文件包含API密钥、项目ID等敏感信息，泄露后可能带来安全风险。

你的报错信息参考：
FAILURE: Build failed with an exception.

• What went wrong: Execution failed for task ':app:pr...

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