Stream error: error decoding response body

🔍 报错分析

1. 🌐 错误翻译

原文：API Error: Stream error: error decoding response body
译文：API错误：流错误：解码响应体出错

2. 🎯 原因分析

该错误表明在处理API响应时，服务端返回的数据流无法被正确解码。常见原因包括：

服务端返回了不符合预期的数据格式（如JSON解析失败、数据损坏或编码格式不匹配）

网络传输过程中数据包损坏导致响应体不完整

客户端与服务端之间的数据编码/解码方式不一致（如gzip压缩未正确处理）

API服务端本身存在故障，返回了非标准或无效的响应

3. 💡 解决方案

#### 步骤1：检查响应数据的完整性和格式

// 以Node.js为例，增加响应数据处理逻辑
const response = await fetch(apiUrl);

// 先检查响应状态码，非2xx直接处理错误
if (!response.ok) {
  throw new Error(`API请求失败，状态码: ${response.status}`);
}

// 检查响应头，确认数据类型和编码
const contentType = response.headers.get('content-type');
if (!contentType?.includes('application/json')) {
  throw new Error(`响应格式错误，预期JSON，实际: ${contentType}`);
}

// 处理可能的压缩数据（如gzip）
const encoding = response.headers.get('content-encoding');
if (encoding === 'gzip') {
  const decompressed = await new Response(response.body, {
    headers: { 'Content-Encoding': 'identity' }
  }).text();
  return JSON.parse(decompressed);
}

// 正常解析响应体
try {
  const data = await response.json();
  return data;
} catch (e) {
  // 解析失败时，打印原始响应体排查问题
  const rawBody = await response.text();
  console.error('原始响应体:', rawBody);
  throw new Error(`响应体解码失败: ${e.message}，原始数据: ${rawBody.slice(0, 500)}`);
}

#### 步骤2：若为服务端问题，联系API提供方
若确认客户端解码逻辑正确，可排查服务端是否：

返回了不完整的响应（如超时中断）

变更了接口返回格式未同步告知

存在服务异常，返回了非标准数据

4. 🛡️ 预防措施

数据校验与容错：始终对API响应做格式校验，使用try