使用Walmart Sandbox API遇TypeError: Failed to fetch但状态码200的问题

问题概述 #

• 调用Walmart Sandbox API时触发TypeError: Failed to fetch错误
• 后续返回状态码200，但无法确认响应是否正常
• 已配置所有必填请求头

可能原因及排查方向 #

1. 浏览器CORS拦截
   Failed to fetch在浏览器环境里大多和跨域有关——哪怕后端返回了200，浏览器如果检测到响应头没有正确配置Access-Control-Allow-Origin等CORS字段，就会拦截响应，抛出这个错误。去浏览器开发者工具的Network面板看一下请求的响应头，有没有CORS相关的报错提示。

2. 请求中途中断
   比如请求发送后网络临时波动导致连接断开，但后端已经完成处理并返回200，前端因为连接断了触发fetch错误，同时可能拿到不完整的响应数据。检查下响应体是不是完整，有没有符合API文档里的预期格式。

3. 响应解析失败
   fetch本身不会因为HTTP状态码非200抛出错误，但如果你的代码里尝试把响应解析成JSON（比如用response.json()），而实际返回的不是合法JSON，就会在这一步报错，同时之前的状态码200可能被忽略。可以直接打印响应的文本内容，看看是不是符合预期。

4. Sandbox环境模拟逻辑
   Walmart的Sandbox可能会模拟一些异常场景，哪怕你参数都对，也可能先触发错误再返回200。去翻一下官方API文档里的Sandbox说明，有没有提到这类模拟规则。

排查步骤 #

• 用Postman或者curl这类工具直接发请求，排除浏览器CORS的影响，看看API本身能不能返回正常响应。
• 打开浏览器开发者工具的Network面板，查看该请求的完整详情：请求头是不是全对，响应头有没有CORS问题，响应体是不是完整且符合格式。
• 检查你的fetch代码，给响应解析步骤加异常捕获，比如：

fetch(url, options)
  .then(response => {
    console.log('状态码:', response.status);
    return response.text(); // 先转文本看原始内容，再尝试转JSON
  })
  .then(data => console.log('响应内容:', data))
  .catch(err => console.error('错误:', err));

• 再核对一遍Walmart API的必填参数和签名规则，有些必填项可能藏在文档的细节里，比如时间戳、签名算法之类的。

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