Jetpack Compose地图真机无法运行求助（非API Key问题）

以下是针对你问题的排查和解决建议：

• 检查Google Cloud控制台的API Key配置细节
  虽然已添加SHA1/SHA256，但需确认：

  • API Key的应用限制是否同时绑定了当前项目的包名，以及debug、release环境对应的所有签名证书（包括Firebase关联的签名）；
  • 该API Key是否已启用Maps SDK for Android服务，避免漏开导致权限不足。

• 核对Manifest配置完整性

  • 确保<meta-data android:name="com.google.android.geo.API_KEY"标签放置在<application>标签内部，而非外部；
  • 确认已添加完整的网络权限：

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

  • 添加地图必需的OpenGL特性声明（放在Manifest根节点）：

    <uses-feature
        android:glEsVersion="0x00020000"
        android:required="true" />
    

• 验证物理设备环境

  • 检查设备网络是否能正常访问Google服务（可通过其他依赖Google服务的APP测试）；
  • 确保设备上的Google Play服务为最新版本，旧版本可能与你使用的高版本Maps依赖不兼容。

• 清理项目缓存并重构
  执行./gradlew clean命令，然后在Android Studio中选择File > Invalidate Caches / Restart，重新打包安装到物理设备，排除缓存导致的配置不生效问题。

• 排查Firebase与Maps的初始化冲突
  暂时注释Application类中的Firebase初始化代码，测试地图是否能正常加载，确认是否存在Firebase初始化干扰Maps服务初始化的情况。

内容的提问来源于stack exchange，提问作者Aris Guimerá