如何将授权路由的Express.Request.user类型从可选改为必填User

方法一：扩展Express Request类型 + 自定义验证中间件 #

这是最安全的方案，既能让TypeScript识别req.user为确定的User类型，又能在运行时兜底校验。

1. 定义自定义User类型
   先明确你的用户实体类型，比如：

// src/types/user.ts
export interface User {
  id: string;
  email: string;
  // 其他业务属性，比如username、role等
}

2. 扩展Express的Request类型
   创建自定义类型声明文件src/types/express.d.ts，覆盖Express默认的Request.user类型：

// src/types/express.d.ts
import { User } from './user';

declare namespace Express {
  interface Request {
    user: User; // 将原有的可选类型改为必选的自定义User类型
  }
}

3. 配置tsconfig.json确保类型被识别
   在tsconfig.json中添加类型文件的扫描路径，确保TypeScript能读取到自定义声明：

{
  "compilerOptions": {
    "typeRoots": ["./node_modules/@types", "./src/types"],
    "target": "ES2020",
    "module": "commonjs",
    "outDir": "./dist",
    "strict": true
  },
  "include": ["src/**/*"]
}

4. 添加兜底验证中间件
   虽然Passport的authenticate中间件在验证失败时会直接返回401，但为了避免极端情况（比如中间件配置错误），可以写一个简单的中间件确保req.user存在：

// src/middlewares/auth.ts
import { Request, Response, NextFunction } from 'express';

export const ensureUserExists = (req: Request, res: Response, next: NextFunction) => {
  if (!req.user) {
    return res.status(401).json({ message: 'Unauthorized' });
  }
  next();
};

5. 在路由中使用
   现在在受保护路由里，req.user会被TypeScript识别为确定的User类型，无需每次手动检查：

app.get(
  '/authenticated',
  authPassport.authenticate('jwt', { session: false }),
  ensureUserExists,
  (req, res) => {
    console.log(req.user.email); // 直接访问，无类型报错
    res.send('you are authenticated');
  }
);

方法二：类型断言（快速但需谨慎） #

如果你能完全保证Passport中间件已经拦截了未认证请求，也可以直接用类型断言跳过类型检查：

app.get(
  '/authenticated',
  authPassport.authenticate('jwt', { session: false }),
  (req, res) => {
    const user = req.user as User; // 强制断言为User类型
    console.log(user.email);
    res.send('you are authenticated');
  }
);

注意：这种方式没有运行时校验，如果Passport中间件出现异常，会导致undefined访问属性的运行时错误，仅推荐在开发阶段快速验证或完全信任中间件的场景使用。

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