使用Fastlane与Jenkins CI时的Android调试密钥库问题

核心结论 #

Fastlane本身不会主动生成调试密钥库，但如果它调用的Android构建工具（Gradle）找不到你指定的debug.keystore，就会自动生成新的调试密钥库——这就是你每次预发布构建签名和证书有效期变化的原因。

可能的操作错误点 #

• keystore复制未成功：
  你的Jenkinsfile中使用sh "cp ${env.KEYSTORE_PATH}/*.keystore app"复制密钥库，但可能存在以下问题：

  • ${env.KEYSTORE_PATH}路径错误，导致找不到debug.keystore；
  • Linux环境下路径大小写不匹配，比如实际路径是Debug.keystore但你写的是debug.keystore；
  • app目录的权限问题，导致cp命令无法写入文件。
    可以在Jenkinsfile中添加调试命令验证：

  sh "ls -l ${env.KEYSTORE_PATH}" # 确认源路径下的keystore文件
  sh "ls -l app/" # 确认目标路径是否有复制后的debug.keystore
  

• Gradle/Fastlane未指定debug签名配置：
  即使你复制了debug.keystore，如果Gradle的debug构建变体没有明确指定使用该文件，会默认自动生成新的调试密钥库。检查你的build.gradle（或build.gradle.kts）中是否正确配置了debug签名：

  android {
      signingConfigs {
          debug {
              storeFile file("app/debug.keystore") // 指向你复制的文件路径
              storePassword "你的debug keystore密码"
              keyAlias "你的debug密钥别名"
              keyPassword "你的debug密钥密码"
          }
      }
      buildTypes {
          staging { // 你的预发布构建类型
              signingConfig signingConfigs.debug
              // 其他staging配置
          }
      }
  }
  

  同时检查Fastlane的lane配置，确保staging构建调用的是正确的Gradle任务，且没有覆盖签名配置：

  lane :staging do
      gradle(
          task: "assembleStaging",
          build_type: "Staging"
          # 不要添加会覆盖签名的参数，比如use_debug_signing: false（如果有需要确保正确）
      )
  end
  

• Docker临时节点的文件生命周期问题：
  由于使用临时Docker从属节点，要确保keystore复制操作在Gradle构建之前执行，且复制后的文件在构建过程中不会被清理或覆盖。比如如果Docker容器在初始化阶段复制了keystore，但后续步骤中app目录被重新挂载或清空，也会导致Gradle找不到文件。

验证步骤 #

1. 查看Jenkins构建日志，搜索是否有Gradle输出的"Generating new debug keystore"相关信息，确认是否是自动生成的情况；
2. 执行上述的ls调试命令，确认keystore文件的存在性；
3. 手动在Docker容器中模拟构建流程，复制keystore后执行Gradle构建，看是否能正常使用指定的debug.keystore。

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