Xero API离线访问令牌获取异常求助：无refresh token及scope问题

核心问题分析 #

你遇到的情况是：授权时指定了包含offline_access的完整scope，但返回的token仅包含openid，且未生成refresh token；直接对scope做Server.URLEncode编码又触发无效scope错误，这通常是scope参数传递方式或Xero应用配置的问题。

具体修复步骤 #

1. 检查Xero应用的权限配置

   • 登录Xero开发者后台，确认你的应用已勾选accounting.transactions等所需权限，同时必须开启离线访问权限。如果应用本身未配置这些权限，即便请求里写了对应scope，Xero也会忽略多余权限，仅返回openid。

2. 正确传递scope参数（无需整体编码，仅替换空格）

   • Xero授权接口要求scope中的空格用+替换，而非对整个字符串做Server.URLEncode编码（编码会转义冒号、斜杠等字符，导致Xero无法识别scope）。
   • 修改VB代码中scope的拼接逻辑，将原Scope变量里的空格替换为+：

     URL += "&scope=" & Replace(Scope, " ", "+")
     

   • 例如原Scope值"openid profile email accounting.transactions offline_access"，替换后变为"openid+profile+email+accounting.transactions+offline_access"。

3. 确认授权流程的权限确认环节

   • 重新发起授权时，检查Xero展示的权限列表，确保包含你请求的所有权限（包括离线访问）。如果用户仅同意了openid相关权限，返回的scope也只会有openid。

4. 校验redirect_uri的一致性

   • 确认代码中拼接的redirect_uri与Xero开发者后台配置的完全一致，包括大小写、末尾是否带斜杠等细节。redirect_uri不匹配也可能导致权限被限制。

验证结果 #

修改后重新走授权流程，获取code并调用token接口，正常情况下返回结果会包含refresh_token，且scope字段会显示你请求的所有权限。

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