NestJS+GQL应用Query命名冲突覆盖问题及校验方案咨询

以下方案均不需要大量修改现有业务代码，人力成本极低：

1. 应用启动/构建阶段全局校验（推荐，零业务代码侵入） #

仅需要在根模块添加一段校验逻辑，应用启动时自动扫描所有GraphQL的Query、Mutation名称，发现重名直接抛出错误终止启动，从根源上避免冲突上线。
实现代码参考：

import { Module, OnModuleInit } from '@nestjs/common';
import { GraphQLSchemaHost } from '@nestjs/graphql';

@Module({
  // 原有模块导入逻辑完全不变
  imports: [ModuleB, ModuleA, /* 其他原有导入 */]
})
export class AppModule implements OnModuleInit {
  constructor(private readonly schemaHost: GraphQLSchemaHost) {}

  async onModuleInit() {
    const { schema } = this.schemaHost;
    const queryType = schema.getQueryType();
    const mutationType = schema.getMutationType();
    const filedMap = new Map<string, string>();

    // 校验所有Query字段
    if (queryType) {
      const queryFields = queryType.getFields();
      for (const [fieldName, fieldConfig] of Object.entries(queryFields)) {
        if (filedMap.has(fieldName)) {
          throw new Error(`GraphQL Query冲突：名称「${fieldName}」已被使用，重复定义请检查Resolver`);
        }
        filedMap.set(fieldName, fieldConfig.resolve?.name || '未知Resolver');
      }
    }

    // 校验所有Mutation字段
    if (mutationType) {
      const mutationFields = mutationType.getFields();
      for (const [fieldName, fieldConfig] of Object.entries(mutationFields)) {
        if (filedMap.has(fieldName)) {
          throw new Error(`GraphQL Mutation冲突：名称「${fieldName}」已被使用，重复定义请检查Resolver`);
        }
        filedMap.set(fieldName, fieldConfig.resolve?.name || '未知Resolver');
      }
    }
  }
}

2. 开发阶段ESLint校验 #

配置ESLint规则提前在编码阶段发现问题：

• 直接使用@graphql-eslint/eslint-plugin插件，开启unique-field-definition规则，即可在编写Resolver代码时实时提示重名问题
• 也可以自定义轻量ESLint规则，全局扫描所有带@Query、@Mutation装饰器的方法名，重名直接报错

3. 自动前缀适配（适合需要保留两个同名Query的场景） #

如果业务上需要同时保留两个同名Query的实现，可以在GraphQL全局配置中添加字段转换逻辑，自动为不同模块的Query添加模块名前缀，不需要修改每个Resolver的业务代码：

GraphQLModule.forRoot({
  autoSchemaFile: true,
  // 其他原有配置不变
  transformSchema: (schema) => {
    // 自定义逻辑按Resolver所属模块给Query/Mutation加上前缀
    // 例如ModuleA的同名Query变为a_theThingThatMessesUpStuff，ModuleB的变为b_theThingThatMessesUpStuff
    return schema;
  }
})

内容的提问来源于stack exchange，提问作者Християн Христов