Android Studio模拟器提示‘Couldn't Launch AR’：Google Geospatial API求助

针对你按Geospatial API教程开发AR应用时遇到的「Couldn't launch AR. To continue, connect to the Internet.」错误，以及更换网络后应用崩溃的问题，可按以下步骤逐一排查：

1. 验证API密钥配置正确性 #

• 检查AndroidManifest.xml中是否正确配置了AR Core API密钥，且该密钥已在Google Cloud控制台启用AR Core Geospatial API权限：

  <meta-data
      android:name="com.google.android.ar.API_KEY"
      android:value="你的API密钥"/>
  

• 确认密钥的限制条件（应用包名、SHA-1指纹）与当前开发环境完全匹配，权限不匹配会直接导致网络请求被拦截。

2. 检查网络权限与安全配置 #

• 确保AndroidManifest中声明了必要的网络权限：

  <uses-permission android:name="android.permission.INTERNET"/>
  <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
  

• 若应用运行在Android 9+设备上，需检查网络安全配置：如果AR服务请求涉及HTTP明文传输，需在res/xml/network_security_config.xml中启用明文流量，或确认目标域名已加入信任列表。

3. 确认AR Core依赖与设备兼容性 #

• 核对build.gradle中的AR Core依赖版本与教程指定版本一致，版本不兼容可能引发初始化异常：

  implementation 'com.google.ar:core:1.38.0' // 替换为教程对应版本
  

• 在设备上安装最新版Google Play Services for AR，并通过AR Core官方兼容性工具验证设备支持Geospatial功能。

4. 调试网络请求与崩溃日志 #

• 使用Android Studio的Network Inspector监控AR初始化阶段的网络请求，查看是否存在请求失败、超时或权限错误（如403/404）。
• 提取换网后的Logcat崩溃堆栈信息，重点排查网络切换时的线程处理、API密钥重新验证逻辑是否存在未捕获异常。

5. 其他排查项 #

• 关闭设备的VPN或代理服务，避免路由异常导致AR服务无法连接到官方服务器。
• 清除应用缓存与数据，重启应用后重新尝试初始化AR会话。

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