/** * 认证中间件 —— 从 Authorization: Bearer 解析用户。 * * 用例: * router.use(requireAuth); // 整组路由需要登录 * router.get("/x", requireAuth, handler); // 单路由需要登录 * * 成功:挂 req.userId / req.userPhone,进入下一个中间件。 * 失败:401 { error: "请先登录" },不进入后续处理。 */ import type { NextFunction, Request, RequestHandler, Response } from "express"; import { verifyToken } from "./jwt.js"; declare global { // eslint-disable-next-line @typescript-eslint/no-namespace namespace Express { interface Request { userId?: string; userPhone?: string; } } } export const AUTH_REQUIRED_MESSAGE = "请先登录"; /** * 要求登录的中间件工厂。挂载到需要用户上下文的路由上。 */ export function requireAuth(req: Request, res: Response, next: NextFunction): void { const header = req.headers.authorization; if (typeof header !== "string" || !header.startsWith("Bearer ")) { res.status(401).json({ error: AUTH_REQUIRED_MESSAGE }); return; } const token = header.slice("Bearer ".length).trim(); const payload = verifyToken(token); if (payload === undefined) { res.status(401).json({ error: AUTH_REQUIRED_MESSAGE }); return; } req.userId = payload.sub; req.userPhone = payload.phone; next(); } /** 短路用;路由测试可直接引用该中间件类型。 */ export type { RequestHandler }; export const requireAuthHandler: RequestHandler = requireAuth;