使用Spotify API的Android应用仅Debug模式正常 Release模式无法连接如何解决

1. 签名指纹未登记问题 #

• Debug与Release模式默认使用不同签名文件，对应生成的SHA1指纹完全不同，Spotify API会校验请求应用的签名指纹，仅后台已登记的指纹可通过验证
• 排查操作：执行命令keytool -list -v -keystore 你的Release签名文件路径获取Release签名的SHA1值，确认该值已添加到Spotify开发者控制台对应应用的配置列表中

2. 混淆规则缺失问题 #

• Release模式默认开启ProGuard/R8代码混淆压缩，未配置Spotify SDK防混淆规则时，SDK内部类会被裁剪或重命名，导致调用逻辑异常
• 解决操作：在项目的proguard-rules.pro文件中添加如下规则：

-keep class com.spotify.** { *; }
-keep interface com.spotify.** { *; }
-dontwarn com.spotify.**

3. 应用可见性声明缺失问题 #

• Android 11及以上系统要求应用主动声明需要查询的其他应用包名，部分Debug构建配置会默认授予相关权限，但Release模式会严格校验配置
• 解决操作：在AndroidManifest.xml的manifest根标签下添加如下声明：

<queries>
    <package android:name="com.spotify.music" />
</queries>

4. 构建参数配置差异问题 #

• 检查模块级build.gradle的构建配置，确认Release构建维度下已正确配置Spotify所需的CLIENT_ID、REDIRECT_URI等参数，避免仅在Debug维度配置导致Release模式鉴权参数缺失

内容的提问来源于stack exchange，提问作者Gutsik József