TypeScript中Express路由请求出现重载不匹配错误求助

错误详情 #

(TS) No overload matches this call.
  The last overload gave the following error.
    Argument of type '(req: Request<SerialNumberParams>, res: Response) => Promise<express.Response<any, Record<string, any>> | undefined>' is not assignable to parameter of type 'Application<Record<string, any>>'.
      Type '(req: Request<SerialNumberParams, any, any, ParsedQs, Record<string, any>>, res: Response<any, Record<string, any>>) => Promise<...>' is missing the following properties from type 'Application<Record<string, any>>': init, defaultConfiguration, engine, set, and 63 more.

相关代码 #

Express主文件 #

import express, { Request, Response } from 'express';
import axios from 'axios';
import { BEARER_TOKEN } from './config';
import { URL } from './config';

const app = express();
const PORT = 3000;

app.use(express.static('public'));
interface SerialNumberParams {
    serialNumber: string;
}

app.get('/api/data/:serialNumber', async (req: Request<SerialNumberParams>, res: Response) => {
    const { serialNumber } = req.params;

    if (!serialNumber || serialNumber.length < 5) {
        return res.status(400).json({ error: 'Invalid serial number' });
    }

    const API_URL = `${URL}${serialNumber}/events?page=1`;

    try {
        const response = await axios.get(API_URL, {
            headers: { Authorization: `Bearer ${BEARER_TOKEN}` }
        });

        res.json(response.data);
    } catch (error) {
        res.status(500).json({ error: error.response?.data || 'Error fetching data' });
    }
});

app.listen(PORT, () => {
    console.log(`Server running at http://localhost:${PORT}`);
});

tsconfig.json配置 #

{
    "compilerOptions": {
        "target": "es6",
        "module": "es6",
        "moduleResolution": "node",
        "outDir": "./dist",
        "rootDir": "./src",
        "strict": true,
        "esModuleInterop": true,
        "skipLibCheck": true,
        "forceConsistentCasingInFileNames": true
    },
    "include": [ "src/**/*" ]
}

已尝试的解决方法 #

• 删除dist目录后重新构建
• 删除node_modules并重装所有依赖
• 确认已安装@types/express
• 移除Request和Response类型导入，直接使用隐式类型
• 直接为serialNumber指定类型，不为req/res添加泛型
• 多次重启VS Code

解决方案 #

1. 对齐express与@types/express版本 #

该错误多数源于类型定义包与核心框架版本不兼容：

• 查看当前版本：

  npm list express
  npm list @types/express
  

• 若express为4.x版本，需安装对应4.x系列的类型包：

  npm install @types/express@4.x --save-dev
  

2. 修改tsconfig的module配置 #

将module从es6改为CommonJS，适配express的CommonJS模块本质：

"compilerOptions": {
    // 保留其他配置
    "module": "CommonJS"
}

3. 补全Request泛型参数 #

显式指定泛型的完整参数，帮助TypeScript准确解析类型：

app.get('/api/data/:serialNumber', async (req: Request<SerialNumberParams, any, any, any>, res: Response) => {
    // 函数逻辑不变
});

4. 清除TypeScript缓存 #

执行命令清除TS缓存，解决缓存导致的类型解析异常：

npx tsc --clearCache

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