Bagisto集成Xero时出现授权服务器返回非JSON预期响应报错问题
Xero集成授权报错问题排查指南
核心报错原因
该异常是Xero授权服务器返回的响应格式不符合预期导致:代码逻辑要求获取access token的接口返回JSON格式数据,但实际返回的是HTML错误页、纯文本提示、跳转响应等非JSON内容,getParsedResponse解析后返回的结果不是数组,触发了类型校验异常。
常见触发原因
- 请求配置参数不匹配:传入的
client_id、client_secret、redirect_uri和Xero开发者后台的应用配置不一致,或者grant_type传值错误,Xero直接返回了HTML格式的错误页面 - 网络连通异常:部署代码的服务器无法正常访问Xero接口,被防火墙、WAF或者地域限制拦截,返回了运营商/代理的错误页面
- 环境配置不匹配:应用为沙箱测试状态却调用了生产环境接口,或者生产环境应用未完成发布审核就发起请求,Xero返回了非JSON的权限拦截响应
- 授权凭证失效:使用
authorization_code模式换取token时,传入的授权码已经过期或者已经被使用过一次,Xero返回了非JSON的错误提示 - 权限范围配置缺失:应用未开启获取token所需的对应权限scope,Xero返回权限错误的非JSON响应
排查步骤
- 打印原始响应定位问题
在报错代码行之前添加临时调试代码,输出原始响应的头信息和内容,可直接定位具体错误:
public function getAccessToken($grant, array $options = []) { $grant = $this->verifyGrant($grant); $params = [ 'client_id' => $this->clientId, 'client_secret' => $this->clientSecret, 'redirect_uri' => $this->redirectUri, ]; $params = $grant->prepareRequestParameters($params, $options); $request = $this->getAccessTokenRequest($params); // 临时调试代码,问题解决后删除 $httpClient = $this->getHttpClient(); $rawResponse = $httpClient->send($request); echo "响应头信息:"; var_dump($rawResponse->getHeaders()); echo "原始响应内容:"; var_dump($rawResponse->getBody()->getContents()); exit; // 原有逻辑 $response = $this->getParsedResponse($request); // ... 后续原有代码 }
校验参数一致性
确认client_id、client_secret、redirect_uri三个参数和Xero开发者后台的应用配置完全一致,redirect_uri的协议、域名、路径、末尾斜杠都必须完全匹配,不能有任何差异。确认环境匹配性
如果是测试阶段,确认调用的是Xero沙箱环境的接口,不要和生产环境接口混用;如果是生产环境部署,确认你的Xero应用已经完成发布审核,对应所需的接口权限已经开启。排查网络连通性
在部署代码的服务器上使用curl命令直接请求Xero的token接口,确认可以正常收到响应,没有被拦截。
对应解决方案
- 参数配置错误:修正参数和Xero后台配置保持一致即可
- 网络拦截问题:配置可正常访问Xero接口的海外代理,或者更换支持访问Xero服务的服务器节点
- 授权码失效:重新走OAuth授权流程获取新的授权码,再调用token接口
- 权限缺失:在Xero开发者后台给应用配置所需的权限scope,比如发票创建、支付查询等相关权限,生产应用完成发布审核后再发起请求
内容的提问来源于stack exchange,提问作者Pritesh Bhoi
相关产品推荐
相关产品推荐

