Node.js异步GraphQL请求函数：throw与try catch的选择及优化

核心区别 #

• throw：主动将错误向上传递，把错误处理的责任交给调用当前函数的上层代码，本质是「抛出问题，让调用方解决」。
• try/catch：在当前函数内部捕获错误并处理，比如返回默认值、记录日志、重试请求等，本质是「自己承担问题，不让它扩散」。

优劣场景 #

没有绝对的「更优」，完全取决于函数的职责和使用场景：

• 优先用throw的情况：如果当前函数是通用工具（比如这个getData是数据获取工具），它不应该决定错误的业务处理逻辑（比如要不要提示用户、要不要返回特定响应），这时抛出错误让上层业务代码处理，能保持函数职责单一。
• 优先用try/catch的情况：如果当前函数能直接处理错误（比如捕获后返回默认数据、自动重试3次），或者需要在当前层记录详细日志，这时直接捕获处理更高效，避免错误层层传递增加复杂度。

原函数存在的问题 #

1. 错误信息模糊：比如Unable to parse没说明是HTTP状态码错误、网络问题还是GraphQL业务错误，排查困难；
2. Error构造函数使用错误：原代码中throw new Error('An error occurred', result.errors.map(...))，Error的第二个参数是配置对象，不是错误详情数组，导致错误信息丢失；
3. 未处理fetch网络错误：比如网络中断、DNS失败时，fetch会直接抛出未捕获的Promise rejection；
4. 缺乏日志记录：后端发生错误时没有留下上下文信息，无法快速定位问题。

优化后的代码 #

import GET_DATA from './getData.gql';
// 替换成你实际使用的日志工具，比如winston、pino
import { logger } from './logger';

const getData = async (url: string) => {
  let response;
  try {
    const options = {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({
        query: GET_DATA,
        variables: { url },
      }),
    };

    response = await fetch(process.env.ENDPOINT, options);

    // 处理HTTP状态码错误，携带具体状态信息
    if (!response.ok) {
      const errorMsg = `请求失败：HTTP ${response.status} ${response.statusText}`;
      // 记录日志，包含关键上下文
      logger.error(errorMsg, {
        statusCode: response.status,
        requestUrl: url,
        graphqlEndpoint: process.env.ENDPOINT
      });
      throw new Error(errorMsg);
    }

    const result = await response.json();

    // 处理GraphQL返回的业务错误
    if (result.errors?.length) {
      const errorMessages = result.errors.map((e: { message: string }) => e.message).join('; ');
      const errorMsg = `GraphQL查询错误：${errorMessages}`;
      logger.error(errorMsg, {
        graphqlErrors: result.errors,
        requestUrl: url,
        query: GET_DATA
      });
      throw new Error(errorMsg);
    }

    return result.data.page;
  } catch (err) {
    // 捕获网络错误或其他未预见的错误
    const baseMsg = err instanceof Error ? err.message : '未知错误';
    const errorMsg = `数据获取失败：${baseMsg}`;
    logger.error(errorMsg, {
      requestUrl: url,
      graphqlEndpoint: process.env.ENDPOINT,
      originalError: err
    });
    // 重新抛出错误，让上层业务代码处理
    throw new Error(errorMsg);
  }
};

export default getData;

优化点说明 #

1. 错误信息具象化：
   • HTTP错误明确标注状态码和状态文本，比如请求失败：HTTP 500 Internal Server Error；
   • GraphQL错误拼接所有业务错误消息，避免信息丢失。
2. 完善日志上下文：
   • 每个错误场景都记录关键信息：请求的url、GraphQL接口地址、错误详情、查询语句，后端排查问题时能快速定位。
3. 统一错误捕获：
   • 用try/catch包裹整个逻辑，捕获fetch网络错误，避免未处理的Promise rejection；
   • 捕获后先记录日志，再重新抛出包装后的错误，既保留排查依据，又不影响上层业务逻辑的错误处理。
4. 类型修正：将GraphQL错误对象的类型调整为{ message: string }，符合实际返回结构，避免类型错误。

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