Express中如何实现异步后置处理JSON响应的签名中间件

原有写法的问题 #

你之前尝试的替换res.json的思路是对的，问题不在「用async函数替换同步原生方法」——Express本身不校验res.json的返回值是否为Promise，真正的问题是缺少边界处理：

• 没有缓存绑定了正确上下文的原生方法引用，部分场景下调用原生方法会丢失res上下文
• 没有判断响应头是否已经发送，极端场景下会触发「重复发送响应」的报错
• 没有做签名失败的异常捕获，签名逻辑抛错时会直接挂掉请求

可直接落地的实现代码 #

核心逻辑是最小范围重写res.json，只拦截待返回的业务数据，等异步签名完成后，再把包装好的结构交给原生res.json完成序列化、设置响应头、发送响应的全流程，不要自己重写底层响应逻辑：

export function signatureMiddleware(req, res, next) {
  // 提前缓存绑定了当前res上下文的原生json方法，避免后续调用丢失上下文
  const originalJsonMethod = res.json.bind(res);

  // 替换对外暴露的res.json方法
  res.json = async function (businessData) {
    // 边界判断：如果响应已经发送，直接终止逻辑避免报错
    if (res.headersSent) return;

    try {
      // 执行异步签名，替换为你项目里实际的签名生成逻辑即可
      const signature = await generateSignature(businessData);
      // 包装成要求的统一结构
      const wrappedResponse = {
        signature,
        content: businessData
      };
      // 交给原生方法完成最终响应发送
      return originalJsonMethod(wrappedResponse);
    } catch (signError) {
      // 签名失败的错误处理，可根据项目的错误规范自行调整
      res.status(500);
      return originalJsonMethod({
        code: 500,
        message: "响应签名生成失败"
      });
    }
  };

  next();
}

落地注意事项 #

• 这个中间件必须在所有业务路由、其他会返回JSON响应的中间件之前注册，否则后续路由拿到的还是未被替换的原生res.json，会导致拦截失效
• 如果项目中存在直接调用res.send传入对象/数组返回JSON的场景，可以额外重写res.send做兼容，避免漏拦截：

// 在重写res.json的逻辑后补充这段即可
const originalSendMethod = res.send.bind(res);
res.send = function (responseBody) {
  // 识别到传入的是非流、非字符串的结构化数据，转交重写后的res.json走签名逻辑
  if (typeof responseBody === 'object' && responseBody !== null && !res.headersSent) {
    return res.json(responseBody);
  }
  return originalSendMethod(responseBody);
};

• 不需要担心async函数带来的同步问题：只要在异步签名过程中没有其他逻辑调用响应发送方法，Express会等待当前逻辑执行完成后正常返回响应，不会出现响应提前截断的问题
• 如果签名逻辑需要关联响应状态码、响应头，可以在签名逻辑中通过res.statusCode、res.getHeaders()获取对应字段参与计算

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