如何将Express的Response转换为http-proxy要求的ServerResponse类型？

问题本质 #

这个报错是类型定义不匹配导致的：最新的Node.js类型定义中，原生ServerResponse的req属性被定义为必选的IncomingMessage类型，而Express的Response类型里req被标注为可选，所以静态检查不通过。实际运行时Express的Response完全继承自原生ServerResponse，不存在功能兼容问题。

可行解决方法 #

• 临时兼容：类型断言
  直接通过类型断言跳过静态检查，运行时不会有问题：

  async proxyCall(req: Request, res: Response): Promise<ProxyCallResponse> {
    return new Promise((resolve, reject) => {
      this.pendingPromises.set(req, {resolve, reject});
      // 两层断言解决类型不兼容问题
      this.proxy.web(req, res as unknown as ServerResponse);
    });
  }
  

• 全局修复：扩展Express类型定义
  在项目的类型声明文件（比如global.d.ts）中补全Express Response的req属性类型，避免每次写断言：

  import type { IncomingMessage } from "http";
  import type { Request } from "express";
  
  declare global {
    namespace Express {
      interface Response {
        // 覆盖原来的可选定义，标注为必选
        req: Request & IncomingMessage;
      }
    }
  }
  

  添加后无需修改业务代码，TS会自动识别类型兼容。
• 类型收窄方案
  如果不想用断言也不想改全局类型，可以在调用proxy前先判断res.req存在，TS会自动收窄类型：

  async proxyCall(req: Request, res: Response): Promise<ProxyCallResponse> {
    if (!res.req) {
      return Promise.reject(new Error('请求上下文异常'));
    }
    return new Promise((resolve, reject) => {
      this.pendingPromises.set(req, {resolve, reject});
      this.proxy.web(req, res);
    });
  }
  

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