LowCode-Engine 中获取 HTTP 错误响应体的解决方案

在基于 LowCode-Engine 开发应用时，处理 HTTP 请求错误是一个常见的需求。当服务端返回 4xx 或 5xx 状态码时，开发者通常需要获取完整的错误响应体内容，以便进行更精确的错误处理和用户提示。

问题背景

LowCode-Engine 提供了全局的错误处理机制，通过配置 onError 回调函数可以捕获请求异常。然而，默认情况下，onError 回调中的 error 参数仅包含基本的状态码和简单消息，不包含服务端返回的完整响应体。

默认行为分析

当 HTTP 请求返回非 2xx 状态码时，LowCode-Engine 的默认处理流程会：

1. 首先检查响应状态码
2. 如果状态码非 2xx，则构造一个简化的错误对象
3. 这个错误对象通常只包含：
   • status：HTTP 状态码
   • message：简单的错误描述
   • log：日志标记

解决方案

要获取完整的错误响应体，可以通过以下两种方式实现：

方法一：自定义 fit 函数

LowCode-Engine 允许开发者自定义请求的 fit 处理函数，用于处理原始响应数据：

{
  requestHandlers: {
    fit: (res) => {
      console.log('完整响应:', res);
      if (res.status >= 400) {
        return Promise.reject({
          ...res,
          errorMsg: res.message || '请求错误'
        });
      }
      return res;
    }
  },
  onError: (error) => {
    console.log('捕获错误:', error);
    // 这里可以访问完整的错误对象
  }
}

方法二：使用拦截器

对于更复杂的场景，可以添加请求拦截器来捕获完整响应：

{
  requestHandlers: {
    request: (options) => {
      return fetch(options.url, options)
        .then(async (response) => {
          const data = await response.json();
          if (!response.ok) {
            return Promise.reject({
              status: response.status,
              data, // 包含完整的响应体
              message: data.message || '请求错误'
            });
          }
          return data;
        });
    }
  }
}

最佳实践建议

1. 统一错误格式：建议服务端和前端约定统一的错误响应格式，便于处理
2. 错误分类处理：根据不同的状态码和错误类型，提供不同的用户提示
3. 日志记录：重要的错误信息应该记录到日志系统
4. 用户友好提示：将技术性错误信息转换为用户能理解的语言

注意事项

• 对于 500 状态码的响应，需要确保 fit 函数能正确处理
• 考虑网络异常等非 HTTP 错误的处理
• 对于敏感信息，在前端展示前应进行过滤

通过以上方法，开发者可以在 LowCode-Engine 中获取完整的 HTTP 错误响应信息，实现更精细的错误处理和用户提示功能。