安卓应用上架Google Play后YouTube API key失效，模拟器可正常运行

核心原因 #

该问题由Google Play应用签名机制导致的签名指纹不匹配引发：
本地/模拟器测试时，应用使用你本地的打包上传密钥进行签名，你在Google Cloud控制台为YouTube API key绑定的正是该上传密钥的SHA-1指纹，因此测试阶段调用正常。
应用上传至Google Play后，平台会使用托管的发布密钥对你的应用重新签名（新应用默认强制开启该服务），此时应用的SHA-1指纹发生变化，和API key预设的允许指纹不匹配，因此API请求被官方拦截。

修复步骤 #

• 进入Google Play Console对应应用管理页，依次打开「设置」>「应用完整性」>「应用签名」标签页，复制「应用签名密钥证书」栏下的SHA-1值
• 进入Google Cloud Console对应项目，依次打开「API和服务」>「凭据」，找到你使用的Android类型YouTube API密钥
• 编辑该API密钥，在「应用限制」的Android应用配置区，新增一条记录，填入应用正式包名和刚才复制的Play签名SHA-1值，保存配置
• 等待5-10分钟配置生效后，重新测试上架版本即可

可选排查项 #

• 确认API密钥绑定的包名和上架应用包名完全一致，无大小写、字符拼写错误
• 确认你用到的YouTube相关API（如YouTube Data API v3、YouTube Player API等）已在Google Cloud控制台正常启用，且配额未达使用上限
• 如果你有多个构建变体，确认所有变体对应的签名SHA-1都已添加到API密钥的允许列表中

上架后报错截图

上架前本地正常运行截图

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