在Express.js中使用TypeScript自定义Response类型失败求助

你遇到的错误是因为TypeScript无法识别自定义的CustomResponse作为Express中间件中res的合法类型——Express内置的中间件类型定义默认res为官方Response类型，直接替换会触发类型不兼容校验。

以下是两种可行的解决方法：

方案一：模块扩展重写Express Response接口（推荐） #

直接扩展Express内置的Response类型，而非自定义新接口，TypeScript会自动全局识别修改后的类型：

// 在项目的类型声明文件中（如express.d.ts），或中间件文件顶部添加
declare module 'express' {
  interface Response {
    myMethod: () => void;
  }
}

// 后续使用无需指定CustomResponse
import express, { Request, Response, NextFunction } from 'express';
const app = express();

app.use((req: Request, res: Response, next: NextFunction) => {
  // 直接定义并调用自定义方法
  res.myMethod = () => {
    res.send('自定义方法执行完成');
  };
  res.myMethod();
  next();
});

注意：确保你的.d.ts文件被tsconfig.json的include字段包含，否则类型扩展不会生效。

方案二：类型断言强制转换 #

若不想全局扩展类型，可在中间件中对res进行类型断言：

import express, { Request, Response, NextFunction } from 'express';

interface CustomResponse extends Response {
  myMethod: () => void;
}

const app = express();

app.use((req: Request, res: Response, next: NextFunction) => {
  const customRes = res as CustomResponse;
  customRes.myMethod = () => {
    res.send('自定义方法执行完成');
  };
  customRes.myMethod();
  next();
});

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