TypeScript扩展Express Request接口报错，求解决方案

错误核心原因 #

你遇到的问题有两个关键诱因：

1. 自定义Request接口未融入Express类型系统：直接定义CRequest继承原生Request，Express的路由处理函数无法自动识别这个自定义接口，导致类型匹配失败。
2. 路由实例可能未正确创建：错误提示显示回调函数被期望是Application类型，说明getUserProfile大概率不是通过express.Router()创建的合法路由实例，而是误用了Express应用实例或其他不符合要求的对象。

分步解决方案 #

1. 用类型声明合并正确扩展Request接口 #

在项目中创建一个类型声明文件（比如src/types/express.d.ts），通过TypeScript的模块扩展特性，让Express原生Request接口自动带上你的自定义属性：

declare namespace Express {
  interface Request {
    // 建议把any替换成i18nObj的实际类型，比如导入对应包的类型后指定，提升类型安全性
    i18nObj: any;
  }
}

确保tsconfig.json包含这个类型文件的路径，示例配置：

{
  "compilerOptions": {
    "typeRoots": ["./node_modules/@types", "./src/types"]
  },
  "include": ["src/**/*"]
}

2. 修正中间件的类型写法 #

修改Middleware.ts，直接使用扩展后的原生Request接口，无需自定义CRequest：

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

// eslint-disable-next-line @typescript-eslint/no-var-requires
const configureI18n = require('../helpers/i18n');
const [_, i18nObj] = configureI18n(false);

const langHeadersMiddleware = (
  request: Request,
  response: Response,
  next: NextFunction
): void => {
  try {
    const language = request.headers['accept-language'];
    i18nObj.setLocale(language || 'en');
    request.i18nObj = i18nObj;
    next();
  } catch (error) {
    i18nObj.setLocale('en');
    next(error); // 不要忘记把错误传递给下一个中间件处理
  }
};

export default langHeadersMiddleware;

3. 确保路由实例正确创建并使用 #

在route.ts中，先确认getUserProfile是合法的路由实例，再直接使用扩展后的Request：

import express from 'express';
import langHeadersMiddleware from './Middleware';

// 必须用express.Router()创建路由实例
const getUserProfile = express.Router();

// 先挂载中间件，确保i18nObj被注入到request对象中
getUserProfile.use(langHeadersMiddleware);

getUserProfile.get(
  '/:id',
  async (request: express.Request, response: express.Response) => {
    try {
      const id = request.params.id;
      // 这里可以直接访问request.i18nObj，类型已被自动识别
      response.json({
        err: 0,
        message: request.i18nObj.__('MESSAGES.USER_FETCH'),
        data: {} // 替换为你的实际业务数据
      });
    } catch (error: any) {
      response.json({ err: 1, message: error.message, error });
    }
  }
);

export default getUserProfile;

额外注意点 #

• 不要跳过中间件挂载：必须确保langHeadersMiddleware在路由处理函数之前被挂载，否则request.i18nObj会不存在。
• 替换any类型：尽量为i18nObj指定具体类型，比如使用i18n包时，可以导入import type { I18n } from 'i18n'，然后将i18nObj类型设为I18n，避免类型模糊。

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