Express.js中使用保护中间件时出现Error TS2769的解决方法

错误原因 #

你遇到的TS2769错误核心是中间件中res参数的类型不匹配：代码里的Response没有从Express库导入，TypeScript默认将其识别为浏览器Fetch API的Response类型，而Express的Response对象有专属的属性和方法（比如headers、statusText等），两者类型定义不一致，导致路由调用时类型校验失败。

修复步骤 #

直接修改保护中间件的类型导入与定义，确保使用Express提供的类型：

修改后的保护中间件代码

import express, { Request, Response, NextFunction } from "express";
import jwt from 'jsonwebtoken'; // 建议替换require为import，符合TS规范
import User from '../model/userModel'; // 同上

export const protect = async (req: Request, res: Response, next: NextFunction) => {
  const { authorization } = req.headers;
  // 后续可添加JWT校验逻辑
  next();
}

如果不想解构导入，也可以直接用express.前缀指定类型：

import express from "express";
const jwt = require('jsonwebtoken');
const User = require('../model/userModel');

export const protect = async (req: express.Request, res: express.Response, next: express.NextFunction) => {
  const { authorization } = req.headers;
  next();
}

额外优化建议 #

• 建议将所有require替换为import，遵循TypeScript模块化规范，避免混合使用导致的潜在类型问题。
• 异步中间件中如果存在异步操作（比如查询数据库、验证JWT），需要捕获错误并传递给next，避免未处理的Promise拒绝：

  export const protect = async (req: Request, res: Response, next: NextFunction) => {
    try {
      const { authorization } = req.headers;
      // 异步逻辑示例
      const user = await User.findById(...);
      next();
    } catch (err) {
      next(err); // 将错误传递给Express错误处理中间件
    }
  }
  

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