调试构建正常但发布构建报AWS密钥不存在错误的原因排查

你的问题很典型——调试构建能顺利拉取PDFTron的依赖，到了release构建就抛出InvalidAccessKeyId错误，核心在于两种构建类型的执行上下文差异。下面是几个最可能的原因，附带排查建议：

• 属性注入/过滤的差异
  Gradle在release构建时可能存在属性处理的特殊逻辑：比如有些项目会对release构建启用属性过滤，或者使用了不同的属性加载策略，导致gradle.properties里的AWS_ACCESS_KEY和AWS_SECRET_KEY没有被正确传递到仓库配置中。
  排查建议：在构建脚本的allprojects.repositories块里添加一行打印代码：println("Release build AWS key: $AWS_ACCESS_KEY")，然后执行./gradlew assembleRelease，看控制台输出的密钥是否正确。如果输出为空或者是占位符，说明属性没被加载到。

• 签名配置的干扰
  你在release构建里配置了signingConfig signingConfigs.release，某些签名插件或配置可能会修改构建环境的属性、环境变量，甚至覆盖AWS相关的凭据。
  排查建议：暂时注释掉release构建的signingConfig行，重新执行release构建。如果能正常下载依赖，那问题就出在签名配置上，需要检查签名插件是否有修改环境属性的逻辑，或者签名过程中是否引入了冲突的系统变量。

• 环境变量与属性文件的上下文差异
  调试构建时，你本地终端可能已经设置了AWS的环境变量（比如AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY），Gradle会优先读取这些环境变量来填充仓库凭据；但到了release构建时（比如在CI环境、新终端，或者构建脚本切换了环境），这些环境变量不存在，只能读取gradle.properties，但如果gradle.properties的路径不对、或者release构建指定了其他属性文件，就会导致密钥读取失败。
  排查建议：检查本地终端的环境变量（执行echo $AWS_ACCESS_KEY_ID），确认调试时是否依赖了环境变量；同时确认release构建时使用的gradle.properties是否和调试时一致，有没有通过-P参数指定其他属性文件。

• Gradle构建缓存的遗留问题
  调试构建时Gradle可能缓存了依赖下载的成功状态，而release构建使用了不同的缓存上下文，导致需要重新验证凭据，但此时凭据没有正确传递。
  排查建议：清理Gradle缓存后重新构建，执行命令：./gradlew clean assembleRelease --no-build-cache，看是否能正常拉取依赖。

• 仓库配置的条件性遗漏
  有可能你的构建脚本里，AWS仓库的配置被意外加上了仅针对debug构建的条件判断（比如if (buildType.name == 'debug')），导致release构建时根本没有应用这个仓库的凭据配置。
  排查建议：仔细检查allprojects.repositories块的代码，确保没有条件性逻辑限制了AWS仓库只在debug时生效。

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