You need to enable JavaScript to run this app. Bagisto集成Xero时出现授权服务器返回非JSON预期响应报错问题
优惠活动
大模型
产品
解决方案
定价
更多

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响应

排查步骤

  1. 打印原始响应定位问题
    在报错代码行之前添加临时调试代码,输出原始响应的头信息和内容,可直接定位具体错误:
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);
    // ... 后续原有代码
}
  1. 校验参数一致性
    确认client_id、client_secret、redirect_uri三个参数和Xero开发者后台的应用配置完全一致,redirect_uri的协议、域名、路径、末尾斜杠都必须完全匹配,不能有任何差异。

  2. 确认环境匹配性
    如果是测试阶段,确认调用的是Xero沙箱环境的接口,不要和生产环境接口混用;如果是生产环境部署,确认你的Xero应用已经完成发布审核,对应所需的接口权限已经开启。

  3. 排查网络连通性
    在部署代码的服务器上使用curl命令直接请求Xero的token接口,确认可以正常收到响应,没有被拦截。

对应解决方案

  • 参数配置错误:修正参数和Xero后台配置保持一致即可
  • 网络拦截问题:配置可正常访问Xero接口的海外代理,或者更换支持访问Xero服务的服务器节点
  • 授权码失效:重新走OAuth授权流程获取新的授权码,再调用token接口
  • 权限缺失:在Xero开发者后台给应用配置所需的权限scope,比如发票创建、支付查询等相关权限,生产应用完成发布审核后再发起请求

内容的提问来源于stack exchange,提问作者Pritesh Bhoi

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.08 10:12:02