Cordova Android调用Spotify API重定向时出现连接拒绝问题

核心问题分析 #

Android设备上，Spotify登录完成后重定向到http://localhost/index.html#access_token=...时出现连接拒绝，本质是WebView在处理带锚点参数的重定向请求时，对localhost的解析或权限处理存在异常——即便直接访问无参数的localhost地址正常，带参数的重定向仍会触发拦截。

可行解决方案 #

1. 改用自定义URL Scheme（最推荐） #

放弃localhost重定向逻辑，用自定义Scheme让Spotify直接唤起Cordova应用，彻底绕开WebView网络请求问题：

• 安装URL Scheme插件：

  cordova plugin add cordova-plugin-customurlscheme --variable URL_SCHEME=yourappscheme
  

• 在config.xml中添加允许Intent配置：

  <allow-intent href="yourappscheme://*" />
  

• 在Spotify开发者后台，将重定向URI设置为yourappscheme://spotify-callback
• 在Cordova代码中监听Scheme回调，解析Token：

  function handleOpenURL(url) {
    if (url.startsWith('yourappscheme://spotify-callback')) {
      const paramStr = url.split('#')[1];
      const params = new URLSearchParams(paramStr);
      const accessToken = params.get('access_token');
      // 此处处理获取Token后的业务逻辑
    }
  }
  

2. 修复localhost重定向的权限配置 #

若坚持使用localhost，需确保WebView允许带参数的重定向请求：

• 在config.xml中补充导航白名单：

  <allow-navigation href="http://localhost/*" />
  <allow-navigation href="http://localhost/index.html#*" />
  

• 同时确认access配置未做限制：

  <access origin="http://localhost" />
  

3. 切换为本地file://协议加载页面 #

将页面加载方式从网络请求改为本地文件协议，避免localhost的网络解析问题：

• 修改config.xml的content配置：

  <content src="index.html" />
  

• 在Spotify后台设置重定向URI为file:///android_asset/www/index.html#callback
• 注意：部分Android系统版本会限制第三方应用（如Spotify）向file协议地址重定向，此方案兼容性略差

4. 调试排查具体原因 #

• 用Chrome调试工具（chrome://inspect）连接设备，查看WebView控制台的详细错误日志，确认重定向请求的具体失败原因
• 检查Cordova项目中是否存在网络拦截类插件，排查是否误拦截了带参数的localhost请求

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