React Native项目通过Microsoft App Center构建遇gradlew返回码1错误

1. 定位具体报错根因 #

gradlew failed with return code: 1是gradle构建失败的通用标识，首先需要拉取App Center对应构建任务的完整日志，筛选标注为ERROR、FAILURE的日志行，明确具体失败环节。

2. 高频问题排查方案 #

• 依赖拉取失败
  检查android/build.gradle、android/app/build.gradle中的maven源配置，App Center公共构建机默认支持谷歌maven、mavenCentral、jcenter等公开源，若使用私有maven源，需要在App Center对应构建分支的配置页补充私有源的认证信息，或替换为可公网访问的镜像源。
• 环境变量缺失
  非生产测试包通常会配置独立的环境变量（如测试环境接口地址、第三方SDK测试密钥等），需确认App Center构建配置中已经完整填写所有用到的环境变量，且拼写、取值和本地测试环境完全一致。
• 签名配置不匹配
  若测试包配置了自定义签名，需要确认你已经在App Center构建配置中上传了正确的签名文件，且填写的keystore密码、key别名、key密码完全匹配。如果是debug测试包，也可以直接关闭App Center的自定义签名配置，让构建机自动生成默认debug签名完成打包。
• 本地复现验证
  在本地开发环境执行命令：
  cd android && ./gradlew assemble<你的测试构建变种名称>
  比如你的非生产构建变种命名为qaDebug，就执行./gradlew assembleQaDebug。如果本地执行也报错，先修复本地构建问题后再提交代码触发App Center构建。
• 缓存问题
  可在App Center构建配置页临时关闭构建缓存，触发一次无缓存构建，排除旧缓存文件导致的构建异常。

3. 截图对应问题处理 #

你上传的两张截图分别对应两类常见构建错误：

第一张截图对应的依赖拉取超时/404问题，按上述依赖拉取失败的方案调整即可
第二张截图对应的资源编译/变量未定义问题，检查测试环境专属的资源配置、AndroidManifest.xml占位符、strings.xml等文件是否存在缺失、冲突

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