Node.js Express(TypeScript)路由用中间件报错无法运行

报错Property 'admin' does not exist on type 'Request<{}, any, any, ParsedQs, Record<string, any>>'的核心原因是：TypeScript对Express的Request类型有严格校验，默认的Request接口并未定义admin属性，直接赋值和访问都会触发类型错误。

以下是两种可行的解决方法：

方法一：通过声明合并全局扩展Request接口（推荐） #

这种方式能全局生效，无需在每个路由/中间件里重复处理类型：

1. 在项目根目录或src文件夹下创建一个express.d.ts类型声明文件，内容如下：

declare namespace Express {
  interface Request {
    admin?: boolean; // 可选属性，匹配你的业务逻辑
  }
}

2. 确保TypeScript能识别这个文件，修改tsconfig.json的include配置，添加该文件路径：

{
  "compilerOptions": {
    // 你的其他编译配置
  },
  "include": ["./src/**/*", "./express.d.ts"] // 将类型声明文件加入编译范围
}

方法二：使用自定义类型或类型断言（临时场景适用） #

如果只是局部需要扩展，可以自定义Request类型或用类型断言绕过检查：

自定义类型方式 #

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

// 定义扩展后的Request类型
interface CustomRequest extends Request {
  admin?: boolean;
}

app.get('/users', auth, (req: CustomRequest, res: Response) => {
    console.log(` User is admin = ${req.admin}`);
    console.log('Users Page');
    res.send('Users Page');
});

// 中间件同步使用自定义类型
function auth(req: CustomRequest, res: Response, next: NextFunction) {
    if (req.query.admin === 'true') {
        req.admin = true;
        next();
    } else {
        res.send('No auth');
    }
}

类型断言方式（快速临时解决） #

直接在访问属性时用as any断言：

app.get('/users', auth, (req, res) => {
    console.log(` User is admin = ${(req as any).admin}`);
    console.log('Users Page');
    res.send('Users Page');
});

注意：类型断言会绕过TypeScript的类型检查，不推荐在全局场景使用，容易隐藏潜在类型问题。

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