Google Map仅发布版显示空白（调试版正常）求助

嘿，我之前也踩过这个坑！既然你已经试过Stack Overflow上的常规方案，那咱们从几个容易被忽略的细节入手排查：

• 核对Release包的SHA-1指纹
  Debug和Release用的是不同签名文件，很多人会误把Debug的SHA-1绑定到Release密钥上。你可以用这条命令生成Release签名的SHA-1：

  keytool -list -v -keystore 你的Release签名文件路径 -alias 你的别名
  

  然后去Google开发者控制台，确认这个SHA-1和你的包名组合，已经正确绑定到对应的API密钥上。

• 确认Build配置里的密钥是否生效
  检查Module级别的build.gradle，确保Debug和Release的API密钥配置没有搞混：

  buildTypes {
      debug {
          buildConfigField "String", "GOOGLE_MAPS_API_KEY", '"你的Debug密钥"'
      }
      release {
          buildConfigField "String", "GOOGLE_MAPS_API_KEY", '"你的Release密钥"'
          // 或者用资源文件方式
          resValue "string", "google_maps_key", '"你的Release密钥"'
      }
  }
  

  同时确认布局文件里的Map组件引用的是正确的密钥资源，比如android:apiKey="@string/google_maps_key"。

• 检查混淆规则是否破坏了Maps类
  如果开启了R8混淆，很可能把Google Maps的核心类混淆了，导致初始化失败。在proguard-rules.pro里添加以下规则：

  -keep class com.google.android.gms.maps.** { *; }
  -keep interface com.google.android.gms.maps.** { *; }
  -keep class com.google.android.gms.location.** { *; }
  -keep interface com.google.android.gms.location.** { *; }
  

  这能保证Maps的关键类不被混淆。

• 抓取Release版本的错误日志
  空白屏幕往往藏着错误信息，用adb抓Release版的日志就能找到问题根源：

  adb logcat *:E
  

  重点看和GoogleMaps、AUTH相关的错误，比如API_KEY_INVALID、SIGNATURE_MISMATCH这类提示，能直接定位问题。

• 确认Release签名配置的正确性
  有时候Android Studio默认的Release签名和你手动生成的不是同一个，检查build.gradle里的签名配置：

  signingConfigs {
      release {
          storeFile file("你的签名文件.jks")
          storePassword "你的存储密码"
          keyAlias "你的密钥别名"
          keyPassword "你的密钥密码"
      }
  }
  buildTypes {
      release {
          signingConfig signingConfigs.release
          // 其他配置
      }
  }
  

  确保这里的签名文件和你用来生成SHA-1的是同一个。

• 检查API启用状态和配额
  去Google开发者控制台确认Maps SDK for Android已经启用，并且你的API密钥关联了这个服务。另外，虽然概率低，但也可以看一下API配额有没有用完——新密钥的默认配额可能有限，不过空白屏幕更多是密钥或签名问题。

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