用TypeScript扩展Express Request对象后报错，求解决方案

问题根源 #

TypeScript未正确识别自定义的Request接口扩展，多因类型声明的作用域、重复定义或配置问题导致。

分步解决方案 #

1. 统一管理类型声明 #

删除中间件内的接口扩展代码，仅在src/types/index.d.ts中定义扩展，避免重复声明冲突：

// src/types/index.d.ts
import 'express-serve-static-core';

declare module 'express-serve-static-core' {
  interface Request {
    companyId?: string; // 可根据实际业务调整类型，如number
  }
}

2. 配置tsconfig.json识别自定义类型 #

检查并调整tsconfig.json，确保TypeScript能读取到你的类型声明文件：

{
  "compilerOptions": {
    "typeRoots": ["./node_modules/@types", "./src/types"],
    "esModuleInterop": true,
    "skipLibCheck": true,
    "strict": true
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules"]
}

• typeRoots：指定自定义类型文件的根目录，让TS优先读取
• include：确保src下所有文件（包括.d.ts）被纳入编译范围

3. 简化中间件实现 #

中间件直接挂载companyId即可，无需重复声明接口：

// 验证会话中间件示例
import jwt from 'jsonwebtoken';

export const authenticateSession = (req, res, next) => {
  const token = req.headers.authorization?.split(' ')[1];
  if (!token) return res.status(401).json({ message: 'Unauthorized' });

  try {
    const decoded = jwt.verify(token, process.env.JWT_SECRET);
    req.companyId = decoded.companyId;
    next();
  } catch (err) {
    return res.status(401).json({ message: 'Invalid token' });
  }
};

4. 控制器正常访问属性 #

在user.controller.ts的getAllUsers中直接使用：

export const getAllUsers = (req, res) => {
  const targetCompanyId = req.companyId;
  // 后续业务逻辑处理
};

额外排查项 #

• 确认.d.ts文件后缀正确，且位于tsconfig.json的include路径下
• 若修改配置后仍报错，重启开发服务器或TS语言服务，确保类型定义被重新加载
• 避免在多个文件中重复扩展express-serve-static-core的Request接口

内容的提问来源于stack exchange，提问作者Sebastian Gómez