Express JWT场景下request.user仅app.ts可访问其他路由取不到如何解决

0. 检查子路由代码低级错误 #

你提供的employeeRouter.ts代码存在参数名不匹配问题：响应形参定义为res，实际调用时用了response，运行时会直接抛出未定义错误，先修正该问题：

employeeRouter.get(
  "/profile",
  (request: Request, res: Response, next: NextFunction) => {
    // 将response替换为实际的形参名res
    res.json({ message: request.user });
  }
);

1. 调整Passport中间件注册顺序 #

必须按以下顺序注册中间件，顺序错误会导致Passport挂载的user属性无法透传到子路由：

// 基础解析类中间件放在最前
app.use(express.json());
app.use(cors());
// 先初始化Passport
app.use(passport.initialize());
// 再注册全局JWT认证中间件
app.use(passport.authenticate("jwt", { session: false }));

// 后面再注册所有业务路由
app.get("/home", (request: Request, response: Response) => {
  response.json({ message: request.user });
});
app.use("/employee", employeeRouter);

遗漏passport.initialize()是这类问题的高频诱因。

2. 修复TypeScript类型扩展问题 #

Express原生Request类型没有定义user属性，需要全局扩展类型，否则TS层面会识别request.user为undefined：

1. 在项目根目录新建types/express/index.d.ts文件，写入以下内容：

import express from "express";

declare global {
  namespace Express {
    interface Request {
      // 替换为你实际的JWT payload字段定义
      user: {
        id: string;
        username: string;
        [key: string]: any;
      }
    }
  }
}

2. 修改tsconfig.json，将自定义类型目录加入类型扫描路径：

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

3. 兜底方案：路由组单独绑定鉴权中间件 #

如果全局中间件被其他逻辑拦截导致透传失效，可以取消全局鉴权注册，给需要保护的路由组单独绑定中间件，同时也能灵活豁免登录、注册等无需鉴权的接口：

// 删除全局的passport.authenticate注册，单独为路由绑定
app.get("/home", passport.authenticate("jwt", { session: false }), (req, res) => {
  res.json({ message: req.user });
});
// 给employee路由组单独绑定鉴权
app.use("/employee", passport.authenticate("jwt", { session: false }), employeeRouter);

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