NestJS GraphQL本地认证：定义仅守卫/拦截器使用的入参

你遇到的矛盾本质是两层规则的冲突：

• GraphQL 层强校验要求所有请求携带的字段参数必须提前在对应 Mutation/Query 上声明，否则直接抛出Unknown argument错误
• ESLint 层会检测方法体内未被引用的参数，标记为无效代码

以下是两种符合官方规范的解决方式，优先选第一种：

方案1：保留@Args声明 + 忽略未使用校验（推荐，适配代码优先/Schema优先所有模式） #

这个方案完全遵循GraphQL参数声明规范，自动生成的Schema类型正确，没有兼容问题。

1. Resolver 层的login Mutation正常声明入参，仅针对该参数加ESLint忽略标记即可，入参实际消费逻辑在GqlLocalAuthGuard中完成：

@Mutation(() => AuthTokenPayload)
@UseGuards(GqlLocalAuthGuard)
async login(
  // 单行注释忽略未使用校验，参数仅用于守卫读取
  // eslint-disable-next-line @typescript-eslint/no-unused-vars
  @Args('createUserInput') createUserInput: CreateUserInput,
  @CurrentUser() currentUser: User
) {
  // 执行到此处时守卫已经完成账号密码校验，无需操作createUserInput
  return this.authService.generateToken(currentUser)
}

如果你的项目ESLint配置了@typescript-eslint/no-unused-vars规则的argsIgnorePattern为^_（大部分NestJS脚手架默认配置），可以直接把参数命名为下划线开头，不需要加注释：

@Args('createUserInput') _createUserInput: CreateUserInput,

2. 自定义GqlLocalAuthGuard的getRequest方法正常从GraphQL上下文提取参数，挂载到req.body供Passport本地策略读取即可：

import { ExecutionContext, Injectable } from '@nestjs/common';
import { GqlExecutionContext } from '@nestjs/graphql';
import { AuthGuard } from '@nestjs/passport';

@Injectable()
export class GqlLocalAuthGuard extends AuthGuard('local') {
  getRequest(context: ExecutionContext) {
    const gqlContext = GqlExecutionContext.create(context);
    const request = gqlContext.getContext().req;
    // 把GraphQL传入的登录参数挂载到req.body，适配Passport本地策略的读取逻辑
    request.body = gqlContext.getArgs().createUserInput;
    return request;
  }
}

3. 可正常发起携带createUserInput参数的Mutation请求，不会报未知参数错误：

mutation Login($input: CreateUserInput!) {
  login(createUserInput: $input) {
    accessToken
    userInfo {
      id
      username
    }
  }
}

方案2：自定义参数装饰器统一处理（适合多Resolver复用场景） #

如果多个Mutation/Query都有同类仅给守卫用的入参，可以封装自定义装饰器统一处理参数提取+挂载逻辑，减少重复的ESLint忽略注释：

// 自定义装饰器
export const LocalAuthInput = createParamDecorator(
  (_data: unknown, context: ExecutionContext) => {
    const gqlCtx = GqlExecutionContext.create(context);
    const req = gqlCtx.getContext().req;
    req.body = gqlCtx.getArgs().createUserInput;
    return null;
  }
);

在Resolver中使用时同样需要声明@Args保证GraphQL层识别参数，搭配自定义装饰器不需要额外写参数处理逻辑：

@Mutation(() => AuthTokenPayload)
@UseGuards(GqlLocalAuthGuard)
async login(
  @Args('createUserInput') _input: CreateUserInput,
  @LocalAuthInput() _authTrigger: null,
  @CurrentUser() currentUser: User
) {
  return this.authService.generateToken(currentUser);
}

注意：不要尝试不声明@Args直接从GqlExecutionContext中捞参数，GraphQL校验层会在守卫执行前就过滤掉未声明的参数，直接抛出未知参数错误，没有兼容空间。

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