React Native Expo独立应用MapView崩溃及谷歌功能异常问题排查

一、MapView首次进入崩溃、二次进入卡顿问题排查 #

• Google Maps API权限校验
  • 确认app.json中配置的Android端config.googleMaps.apiKey、iOS端config.googleMapsApiKey，已在对应服务控制台开启「Maps SDK for Android」「Maps SDK for iOS」的使用权限。开发环境下Expo会自动注入临时地图配置，独立包使用自定义API Key时，若未开通对应SDK权限，首次加载地图会直接触发原生层崩溃。
  • 排查原生组件内存泄漏问题：二次进入卡顿通常是首次崩溃后遗留的地图原生实例未被正确销毁，需检查MapView所在路由页面的卸载逻辑，确保组件卸载时主动清理所有地图绑定的定位监听、相机移动回调、覆盖物渲染的事件引用，避免原生层对象堆积占用主线程资源。
• 打包配置影响排查
  • 检查当前packagerOpts.sourceExts配置，确认没有将svg等非原生地图可直接解析的资源类型，强行纳入地图资源加载链路，避免地图渲染时反复解析无效资源造成主线程阻塞。
  • 核对assetBundlePatterns规则，确认没有将冗余测试资源重复打包进独立包，减少地图初始化时的资源加载耗时。
• 版本兼容性校验
  • 确认使用的地图组件（react-native-maps/expo-maps）版本和当前项目使用的Expo SDK版本完全匹配。开发环境下的热更新机制不会校验原生模块版本的对齐关系，独立打包时若存在原生模块版本错配，会直接触发原生层崩溃。

二、谷歌登录、推送通知、深链接独立包功能失效问题排查 #

• 签名证书匹配校验
  • 核对从Expo凭证页获取的SHA1证书类型：凭证页会同时展示开发、生产两套签名的SHA1，需确保同步到Firebase、Google控制台的是生产包对应的SHA1。若仅同步了开发调试用的SHA1，独立包使用生产签名发起的所有第三方服务请求都会被直接拦截。
  • 确认Android端配置的package字段、iOS端配置的bundleIdentifier，和Firebase、Google控制台中登记的应用标识完全一致，不存在拼写、大小写偏差。
• 深链接配置校验
  • 确认app.json中定义的scheme参数已被正确打包进独立应用的原生配置中。开发环境下Expo开发客户端会自动处理scheme跳转逻辑，独立包需原生层完成intent过滤规则注册才能正常响应深链接跳转。
• 推送功能配置校验
  • 确认项目根目录引入的google-services.json（Android）、GoogleService-Info.plist（iOS），是和当前生产包名、生产SHA1匹配的版本，而非开发环境下临时生成的配置文件。开发环境下Expo会自动注入临时Firebase配置，独立打包时必须使用自有项目关联的Firebase配置才能正常接收推送通知。
• 谷歌登录配置校验
  • 确认iOS端配置的googleSignIn.reservedClientId，和Google控制台生成的iOS专属OAuth Client ID完全匹配，没有误填入Web端服务的Client ID。同时需确认Android端谷歌登录的OAuth客户端已关联生产包对应的SHA1，避免登录请求因签名校验失败被拦截。

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