Spotify Android 应用重定向 URI 配置完整指南-java教程-PHP中文网

Spotify Android 应用重定向 URI 配置完整指南

本文详解 Spotify Android 认证中重定向 URI（redirect_uri）的正确格式、配置方法与常见陷阱，涵盖 AndroidManifest.xml、build.gradle、Spotify 开发者控制台三端一致性校验，并提供可直接运行的代码示例与排错清单。

本文详解 spotify android 认证中重定向 uri（redirect_uri）的正确格式、配置方法与常见陷阱，涵盖 `androidmanifest.xml`、`build.gradle`、spotify 开发者控制台三端一致性校验，并提供可直接运行的代码示例与排错清单。

在 Spotify Android 应用开发中，重定向 URI 是 OAuth 2.0 授权流程成功落地的关键枢纽。它并非任意字符串，而是需严格遵循 scheme://host 格式、并在三方（App 代码、Android 清单、Spotify 控制台）完全一致的自定义 URI。若任一环节不匹配，将直接触发 Missing required parameter: redirect_uri 错误，导致授权中断。

✅ 正确格式与命名规范

重定向 URI 必须是自定义协议（Custom Scheme），不能使用 http:// 或 https://（这些仅适用于 Web 应用）。典型格式为：

spotify-sdk://auth
myapp://callback
musicplayer://login

其中：

scheme（协议名）：建议使用应用唯一标识，避免通用词如 app 或 redirect；
host（主机名）：可为任意有意义的字符串（如 auth, callback, spotify-login），但需与后续配置完全一致；
严禁尾部斜杠 / —— myapp://callback/ ≠ myapp://callback，Spotify 会严格校验。

?️ 三步一致性配置（缺一不可）

1. AndroidManifest.xml 中注册 Intent Filter

在主 Activity 的标签内添加如下声明（替换 myapp 和 callback 为你选定的 scheme/host）：

<intent-filter><action android:name="android.intent.action.VIEW"></action><category android:name="android.intent.category.DEFAULT"></category><category android:name="android.intent.category.BROWSABLE"></category><data android:scheme="myapp" android:host="callback"></data></intent-filter>

⚠️ 注意：中不要写 android:path 或 android:port；确保 android:scheme 与 android:host 与你定义的 URI 完全对应。

2. build.gradle（Module: app）中通过 manifestPlaceholders 注入（推荐）

在 defaultConfig 块中配置占位符，便于多环境管理：

Android Adb

执行 Android ADB（Android 调试桥）命令，用于设备管理、应用管理、调试和自动化。当用户请求任何与 ADB 相关的操作时使用。

下载

android {
    defaultConfig {
        manifestPlaceholders = [
            redirectSchemeName: "myapp",
            redirectHostName:   "callback"
        ]
    }
}

然后在 AndroidManifest.xml 中引用（更灵活、避免硬编码）：

<data android:scheme="${redirectSchemeName}" android:host="${redirectHostName}"></data>

3. Spotify Developer Dashboard 中精确注册

myapp://callback

✅ 支持多个 URI，每行一个；
❌ 不支持通配符（如 myapp://*）、端口（myapp://callback:8080）或路径（myapp://callback/oauth）；
❗ 保存后需等待约 30 秒生效，修改后务必重新测试。

? 初始化认证 Flow 的关键代码（适配新版 auth SDK）

使用 com.spotify.android:auth:2.3.0+（MavenCentral）时，redirectUri 参数应传入 Uri 对象而非字符串：

import com.spotify.android.auth.AuthorizationRequest;
import com.spotify.android.auth.AuthorizationResponse;

// 构建重定向 URI（务必与 manifest 和后台一致）
Uri redirectUri = new Uri.Builder()
    .scheme("myapp")
    .authority("callback")
    .build();

AuthorizationRequest request = new AuthorizationRequest.Builder(
        "YOUR_CLIENT_ID",
        AuthorizationResponse.Type.TOKEN, // 或 CODE
        redirectUri,
        AuthorizationScope.USER_READ_PLAYBACK_STATE,
        AuthorizationScope.USER_MODIFY_PLAYBACK_STATE)
    .setShowDialog(true)
    .build();

// 启动授权
AuthorizationService authService = new AuthorizationService(this);
authService.authorize(request);

? 提示：AuthorizationService 会自动匹配 AndroidManifest.xml 中注册的 intent-filter，因此 URI 格式必须 100% 匹配，否则回调无法被系统路由至你的 Activity。

? 常见错误与快速排查清单

现象	原因	解决方案
Missing redirect_uri 错误	代码中未传 redirectUri，或传入 null/空字符串	检查 AuthorizationRequest.Builder(...) 构造是否传入有效 Uri
授权后白屏/跳转失败	AndroidManifest.xml 中 scheme/host 与代码不一致	使用 adb logcat 查看 IntentResolver 日志，确认是否匹配到目标 Activity
登录成功但未回调到 App	Spotify 后台未注册该 URI，或格式含空格/换行	进入 Dashboard → Copy URI → 粘贴比对（建议用文本编辑器显示不可见字符）
Custom Tabs 登录后无响应	浏览器缓存了旧会话或失效 Cookie	测试前清除 Chrome / Samsung Internet 的 Cookie 与缓存