如何配置GraphQL Validator使其支持接收空字符串参数

• nullable: true配置仅生效于两种场景：字段入参传null、入参中完全省略该字段，该配置不会干预空字符串""的校验逻辑
• 空字符串是合法的String类型值，不属于null/undefined范畴，你遇到的报错来自框架层默认的校验规则拦截，和GraphQL本身的类型定义无关

按项目技术栈选对应配置即可：

方案1：基于class-validator的校验配置（TypeGraphQL/NestJS GraphQL 主流场景） #

绝大多数这类报错都是class-validator默认校验逻辑导致的，按如下方式调整即可：

1. 给允许空值的字段加上@IsOptional()装饰器，注意字段的TS类型要兼容null/undefined：

import { InputType, Field } from 'type-graphql'; // 若使用NestJS则从@nestjs/graphql导入
import { IsOptional, IsString, Allow } from 'class-validator';

@InputType()
export class EmailFinderSingleRq {
    @Field(() => String, { nullable: true })
    @IsOptional()
    @IsString()
    firstname?: string | null;

    @Field(() => String, { nullable: true })
    @IsOptional()
    @IsString()
    // 若全局开了强制非空校验，额外加@Allow()装饰器即可
    @Allow()
    lastname?: string | null;
}

2. 检查全局校验管道配置（NestJS项目为ValidationPipe），不要开启@IsNotEmpty()相关的全局自动校验，避免空字符串被全局规则拦截。

方案2：自定义String标量放行空字符串 #

如果你的项目自定义了String类型标量、默认拦截长度为0的字符串，直接修改标量解析逻辑即可，示例代码：

import { GraphQLScalarType, Kind } from 'graphql';

export const AllowEmptyStringScalar = new GraphQLScalarType({
  name: 'String',
  parseValue(value) {
    if (typeof value !== 'string') throw new Error('Field value must be string type');
    return value; // 移除长度判断，直接返回字符串值，放行空串
  },
  parseLiteral(ast) {
    if (ast.kind !== Kind.STRING) throw new Error('Field value must be string type');
    return ast.value; // 同理放行空字符串
  },
  serialize(value) {
    return String(value);
  }
});

将该标量注册到GraphQL模块替换默认String标量即可生效。

提示：不要试图通过修改nullable配置解决空字符串校验问题，二者控制的校验维度完全不同。

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