Flutter中google_maps_flutter导致应用崩溃问题求助

云原生阿岚

2026-7-15

解决Flutter google_maps_flutter 崩溃报错：GoogleCertificatesRslt: not allowed

这个报错核心原因是Google服务对API密钥的签名校验不通过，以下是针对性解决步骤：

检查API密钥的限制规则
登录Google Cloud控制台，找到对应Maps SDK的API密钥，确保配置的应用SHA-1指纹和包名与当前应用完全匹配。如果近期更换过签名证书（比如从调试签名切换到正式签名），必须同步更新密钥的限制配置，否则会触发校验失败。
验证本地签名的SHA-1指纹
用命令行生成当前应用签名的SHA-1，对比控制台的记录：
```
keytool -list -v -keystore 你的签名文件路径 -alias 签名别名
```
Android调试签名默认路径一般是~/.android/debug.keystore，别名是androiddebugkey，密码是android。
确认API服务已启用
在Google Cloud控制台的API库中，检查Maps SDK for Android（如果涉及iOS则检查对应SDK）是否处于启用状态，避免因服务被意外关闭导致的权限问题。
清理缓存并重建项目
卸载设备上的应用，执行以下命令清理构建缓存后重新运行：
```
flutter clean
flutter run
```
Android端可额外执行./gradlew clean确保gradle依赖完全刷新。
检查AndroidManifest配置
确认android/app/src/main/AndroidManifest.xml中的API密钥配置正确，字段名称和密钥值无拼写错误：
```
<meta-data
    android:name="com.google.android.geo.API_KEY"
    android:value="你的API密钥"/>
```
注意不要使用旧版的com.google.android.maps.v2.API_KEY字段，需使用最新的com.google.android.geo.API_KEY。