扩展Express Request对象时遇重载错误，如何解决？

使用Passport.js + JWT，尝试扩展Express的Request对象以访问req.user，但以下两种方案均无效：

尝试的方案及问题 #

1. 接口继承方案：重载错误导致无法编译 #

通过继承Express的Request接口自定义IUserRequest，能部分工作但触发重载错误，无法通过tsc编译：

// index.d.ts file
import { IUser } from "../models/user";
import { Request } from "express";

export interface IUserRequest extends Request {
  user: IUser; // or any other type
}

2. 全局命名空间方案：无法访问req.user #

通过全局命名空间扩展Express的Request，但代码中无法识别req.user属性，导入Express的Request还会提示未使用：

// index.d.ts file
import { IUser } from "../models/user";
// import { Request } from "express"

export {};

declare global {
  namespace Express {
    interface Request {
      user?: IUser;
    }
  }
}

访问req.user的控制器代码 #

export const admin_code_post = [
  body("admin_code", "Wrong code buddy")
    .trim()
    .escape()
    .custom((value: string) => {
      if (value !== process.env.SECRET_CODE) {
        throw new Error("Admin code is incorrect");
      }
      return true;
    }),
  (req: IUserRequest, res: Response, next: NextFunction) => {
    const errors = validationResult(req);

    if (!errors.isEmpty()) {
      res.render("admin_code", {
        title: "Enter Code",
        errors: errors.array(),
        user: req.user,
      });
      return;
    }

    User.findOneAndUpdate(
      { username: req.user?.username }, // 使用全局命名空间时此处有问题
      { admin: true },
      (err: Error, user: IUser) => {
        if (err) return next(err);

        res.render("index", {
          title: "Welcome",
          user,
        });
      }
    );
  },
];

tsconfig.json配置 #

{
    "compilerOptions": {
      "target": "es2016",   
      "module": "commonjs", 
      "rootDir": "./src",   
      "typeRoots": [
        "./node_modules/@types",
        "./types"
      ],                    
      "sourceMap": true,    
      "outDir": "dist",     
      "noEmitOnError": true,
      "esModuleInterop": true,
      "forceConsistentCasingInFileNames": true,           
      "strict": true,                                   
      "noImplicitAny": true
    },
    "include": ["./src/**/*"],
    "exclude": ["node_modules"],
    "ts-node": {
      "files": true
    },
    "files": [
      "./src/types/index.d.ts"
    ]
  }

问题诊断与解决建议 #

针对全局命名空间方案的问题 #

1. 类型文件路径匹配修正：你的index.d.ts放在./src/types/下，但typeRoots配置的是根目录下的./types，TypeScript无法正确识别。需要将typeRoots修改为：

   "typeRoots": ["./node_modules/@types", "./src/types"]
   

   或者把类型文件移到根目录的types文件夹下。
2. 控制器类型调整：使用全局扩展后，无需再用自定义的IUserRequest，直接使用Express原生的Request类型即可，此时req.user会被TypeScript自动识别：

   // 控制器中的请求参数改为原生Request
   (req: Request, res: Response, next: NextFunction) => {
     // 可正常访问req.user
   }
   

3. 确保类型文件加载：虽然files数组已包含类型文件，但结合strict: true配置，要保证index.d.ts通过export {}标识为模块文件，且不要导入Request避免破坏全局扩展。

针对接口继承方案的重载错误 #

该错误源于Express路由处理函数对Request类型的重载定义，自定义的IUserRequest无法完全兼容这些重载。官方更推荐全局命名空间的扩展方式，可避免此类类型不兼容问题。

额外注意事项 #

• 确认IUser类型定义正确，且能被index.d.ts正常导入，避免类型引用错误。
• 重启TypeScript语言服务（或编辑器），确保新的类型定义被加载。

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