Flutter应用YouTube API v3仅模拟器可用，Google Play加载失败求解决

1. 检查API密钥的限制配置 #

• 确认Google Cloud控制台中YouTube Data API v3的API密钥，没有设置错误的应用限制：
  • 若用Android应用限制，必须确保包名和SHA-1指纹是Google Play签名后的指纹（而非本地调试指纹），该指纹可在Play Console「应用签名」页面获取。
  • 之前用调试SHA-1的话，发布后必须替换成Play生成的正式指纹，否则API请求会被拒绝。

2. 验证ProGuard规则是否正确 #

确保ProGuard未混淆YouTube API相关类，在android/app/proguard-rules.pro中添加以下规则：

-keep class com.google.api.services.youtube.** { *; }
-keep class com.google.api.client.** { *; }
-keep class com.google.auth.** { *; }
-keepattributes Signature,RuntimeVisibleAnnotations,AnnotationDefault

同时检查build.gradle中minifyEnabled和shrinkResources的配置，发布版本需确保这些开关开启且ProGuard规则生效。

3. 确认网络权限与Play服务依赖 #

• 检查AndroidManifest.xml是否添加必要网络权限：

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

• 确保Google服务依赖版本兼容，在android/build.gradle中：

  dependencies {
      classpath 'com.google.gms:google-services:4.3.15' // 使用稳定兼容版本
  }
  

  并在android/app/build.gradle末尾应用插件：

  apply plugin: 'com.google.gms.google-services'
  

4. 核对Google Play应用签名模式 #

若启用了Google Play应用签名，本地APK/AAB的签名与Play发布后的签名不一致，会导致API密钥的包名+指纹验证失败。务必将Play Console里「应用签名证书」的SHA-1添加到API密钥的允许列表，而非本地调试证书的SHA-1。

5. 捕获并分析错误日志 #

通过Firebase Crashlytics或Google Play Console的「Android vitals」查看发布版本的错误日志，确认API返回的具体错误（比如API_KEY_INVALID、ACCESS_DENIED等），精准定位问题。例如日志显示API key not valid则是密钥配置问题，显示insufficient authentication scopes则需检查请求的权限范围。

6. 检查API配额是否耗尽 #

登录Google Cloud控制台，查看YouTube Data API v3的配额使用情况。若发布后请求量激增导致配额耗尽，也会出现无法加载的情况，此时需申请提高配额。

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