Expo构建Android应用生产环境部分设备react-native-maps显示空白

排查SHA-1密钥配置（最可能触发该问题的原因） #

• 生产环境Android应用的签名SHA-1必须添加到Google Cloud控制台的API密钥限制列表：
  1. 若使用Expo托管工作流，执行expo fetch:android:hashes获取发布版的SHA-1和SHA-256哈希值
  2. 登录Google Cloud控制台，找到对应API密钥的「应用限制」设置，添加SHA-1值+应用包名的组合
  3. 注意区分开发环境和生产环境的SHA-1，两者都需配置到位，避免混淆

验证API密钥的权限与限制规则 #

• 确认Google Cloud中已启用「Maps SDK for Android」服务
• 检查API密钥的「API限制」是否仅允许Maps SDK for Android，避免权限范围过宽或过窄
• 查看API密钥的使用配额，确认是否因配额超额导致部分设备无法加载地图

适配Android版本差异 #

• 针对Android 10及以上（API 29+），若应用需要后台定位能力，需额外添加ACCESS_BACKGROUND_LOCATION权限，在app.config.js中补充：

  permissions: [
    "INTERNET",
    "ACCESS_COARSE_LOCATION",
    "ACCESS_FINE_LOCATION",
    "ACCESS_BACKGROUND_LOCATION"
  ]
  

• 检查目标设备的系统定位服务是否开启，部分Android设备会严格限制应用定位权限，间接导致地图加载失败

检查依赖版本兼容性 #

• 确认react-native-maps版本与当前使用的Expo SDK版本匹配，可对照Expo官方的依赖版本清单
• 尝试将react-native-maps更新至最新兼容版本，修复已知的生产环境渲染bug

调试定位具体问题 #

• 在生产环境设备上通过adb logcat抓取日志，搜索「Google Maps」相关报错信息，精准定位失败原因
• 测试阶段可临时移除API密钥的应用限制（测试完成后务必恢复），验证是否是限制规则导致的加载异常

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