NestJS技术疑问：AuthGuard如何感知已实现的Passport策略？

我在理解 NestJS 与 PassportJS 结合的认证/授权流程时遇到了困难，作为反感开发中“黑魔法”的开发者，我希望弄清楚 AuthGuard 是如何知晓项目中已实现的 Passport 策略（如 Local Strategy 或 JWT Strategy）的。

问题背景 #

我搭建了 AuthModule 和 UserModule 两个模块，相关代码如下：

AuthService #

@Injectable()
export class AuthService {
    constructor(private usersService: UsersService){}

    async validateUser(username: string, password: string): Promise<any> {
        const user = await this.usersService.findOne(username);

        if (user && user.password === password) {
            const {password, ...result} = user
            return result
        }
        return null
    }
}

UsersService #

import { Injectable } from '@nestjs/common';

export type User = any;

@Injectable()
export class UsersService {

    private readonly users = [
        {
            userId: 1,
            username: 'John Marston',
            password: 'rdr1',
        },
        {
            userId: 2,
            username: 'Arthur Morgan',
            password: 'rdr2',
        },
    ]

    async findOne(username: string): Promise<User | undefined> {
        return this.users.find(user => user.username === username)
    }
}

Passport 配置 #

安装 Passport 及 NestJS 相关包后，我在 AuthModule 中导入了 PassportModule，并实现了 LocalStrategy 作为提供者：

LocalStrategy #

@Injectable()
export class LocalStrategy extends PassportStrategy(Strategy) {
    constructor(private authService: AuthService) {
        super()
    }

    async validate(username: string, password: string): Promise<any> {
        const user = await this.authService.validateUser(username, password);

        if (!user) {
            throw new UnauthorizedException();
        }

        return user;
    }
}

AuthModule #

@Module({
  imports: [UsersModule, PassportModule],
  providers: [AuthService, LocalStrategy]
})
export class AuthModule {}

登录路由 #

import { Controller, Post, Request, UseGuards } from '@nestjs/common';
import { AuthGuard } from '@nestjs/passport';

@Controller()
export class AppController {
  
  @UseGuards(AuthGuard('local'))
  @Post('login')
  async login(@Request() req) {
    return req.user;
  }
}

我理解上述代码的执行逻辑，也清楚 req.user 对象的来源，但不明白 AuthGuard 是如何识别到项目中已实现的 LocalStrategy 的。它是通过遍历文件找到 PassportModule 的导入和继承自 PassportStrategy 的 LocalStrategy 吗？我知道 AuthGuard 是一种特殊的 Guard，但尚未完全理解其工作机制。

核心原理拆解 #

AuthGuard 识别 Passport 策略完全依赖 NestJS 的依赖注入（DI）系统，根本没有什么“文件遍历”的黑魔法，核心逻辑分三步：

1. PassportStrategy 自动完成策略注册 #

当你创建 LocalStrategy 并继承 PassportStrategy(Strategy) 时，PassportStrategy 这个工具类会在实例化过程中，自动把当前策略注册到 NestJS 内部维护的 Passport 实例中。

具体来说，调用 super() 时，会根据你传入的基础策略（比如这里的 Strategy 是 passport-local 的核心策略），自动关联策略的默认名称（通常是策略的小写标识，比如 local、jwt），同时把你自定义的 validate 方法绑定到该策略的认证回调上。

2. 依赖注入容器管理策略实例 #

因为你把 LocalStrategy 声明为 AuthModule 的 providers，NestJS 的 DI 容器会在模块初始化时创建这个策略的实例，而刚才提到的注册逻辑就在实例化阶段完成。所有继承自 PassportStrategy 的类，都会被 DI 容器接管，同时自动完成 Passport 系统内的注册。

3. AuthGuard 通过策略名称匹配实例 #

当你使用 AuthGuard('local') 时，AuthGuard 会从 NestJS 内部的 Passport 注册中心，根据传入的名称（local）查找对应的策略实例。找到后，就会触发该策略的认证流程，执行你写的 validate 方法，最终把验证通过的用户信息挂载到 req.user 上。

简单总结：策略是你通过 DI 容器显式声明的，Passport 帮你完成了名称与实例的映射，AuthGuard 只需要按名称调用对应的策略即可，全程都是显式的依赖管理逻辑，没有任何隐式的文件扫描操作。

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