扩展Express Request接口时遇TS错误：No overload matches this call

这个错误的核心是TypeScript无法识别你传入的中间件参数，误将其判定为PathParams（路由路径参数）类型，通常由中间件调用方式错误、类型扩展不当或返回值不符合规范导致，以下是具体解决方法：

1. 修正中间件调用格式 #

Express的app.use()（或路由方法）传参规则是：要么直接传入中间件函数，要么先传路径字符串再传中间件函数。如果参数顺序错误或类型不匹配，就会触发该错误。
正确示例：

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

const app = express();

// 直接使用中间件
app.use(async (req: Request, res: Response, next: NextFunction) => {
  // 中间件逻辑
  next();
});

// 指定路径后使用中间件
app.use('/api', async (req: Request, res: Response, next: NextFunction) => {
  // 中间件逻辑
  next();
});

2. 正确扩展Express Request接口 #

要给Request添加自定义属性，需在TypeScript声明文件中扩展接口，确保类型被全局识别：

• 在项目中创建（或修改）声明文件，比如src/types/express.d.ts：

declare namespace Express {
  interface Request {
    // 这里添加你的自定义属性，例如
    user?: { id: string; username: string };
  }
}

• 确保tsconfig.json包含该声明文件路径：

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

3. 规范异步中间件的返回值与逻辑 #

你的中间件返回了Promise<Response<any, Record<string, any>> | undefined>，但Express中间件无需额外返回值（除非要终止响应）。异步中间件需正确处理错误并调用next()：

app.use(async (req: Request, res: Response, next: NextFunction) => {
  try {
    // 执行异步操作
    const userData = await fetchUserInfo();
    req.user = userData;
    next(); // 传递给下一个中间件
  } catch (error) {
    next(error); // 把错误传递给错误处理中间件
  }
});

4. 确认类型导入正确性 #

确保从express包正确导入所需类型，避免使用错误的类型定义：

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

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