WooCommerce Rest API返回数据为字符串格式问题求助

你在多站点使用WooCommerce REST API时遇到异常：某站点返回JSON格式的字符串（如'[{id:...}]'）而非标准数组，其他站点凭证可正常获取数组，且尝试去除首尾引号、设置Content-Type: application/json请求头无效。以下是针对性的排查思路和解决建议：

一、先确认响应头的Content-Type #

首先检查API响应的Content-Type头：如果服务器返回的是text/plain而非application/json，请求库（如axios，WooCommerce官方Node库基于axios）不会自动将响应解析为JSON对象，导致response.data是字符串。

• 可在代码中打印响应头确认：

  WooCommerce.get("products?lang=en&per_page=5&page=1", {})
  .then(async (response) => {
    console.log("响应Content-Type:", response.headers['content-type']);
    // ... 其他代码
  })
  

二、站点端核心排查方向 #

1. 插件冲突排查 #

• 临时禁用当前站点所有非必要插件（仅保留WooCommerce、多语言插件<因请求带lang=en参数>），测试API是否恢复正常。
• 若恢复，逐个启用插件并测试API，定位导致问题的插件。重点排查：缓存插件（如WP Rocket、W3 Total Cache）、API自定义插件、多语言插件（如WPML、Polylang）、安全插件（如Wordfence）。

2. WooCommerce API设置检查 #

• 进入站点后台WooCommerce > 设置 > 高级 > REST API，确认使用的API版本（建议切换到v3或v2测试，部分站点自定义逻辑可能对新版本兼容不佳）。
• 检查当前API密钥是否拥有read_products权限，避免权限限制导致响应格式异常。

3. 主题自定义代码排查 #

• 临时切换到WooCommerce默认主题（如Storefront）测试API：部分主题会通过woocommerce_rest_prepare_product、rest_prepare_post等钩子修改REST API响应，可能意外将JSON转为字符串输出。
• 若切换主题后正常，检查当前主题的functions.php或自定义插件中的相关钩子代码。

4. 服务器配置排查 #

• 联系主机商检查服务器是否启用了mod_security、Cloudflare等安全/加速服务，这类服务可能误判API响应，修改了Content-Type或对JSON进行额外编码。
• 查看服务器错误日志，排查是否有与REST API相关的报错信息。

三、临时应急方案 #

若暂时无法定位根源，可在代码中手动将字符串解析为JSON对象：

WooCommerce.get("products?lang=en&per_page=5&page=1", {})
.then(async (response) => {
  let products = response.data;
  // 仅当数据为字符串时尝试解析
  if (typeof products === 'string') {
    try {
      products = JSON.parse(products);
    } catch (parseError) {
      console.error("解析响应数据失败:", parseError);
      return;
    }
  }
  console.log(products);
})
.catch((error) => {
  console.error("获取数据出错:", error);
});

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