GraphQL Schema问题：如何实现用户名/邮箱查询用户及参数校验

首先直接给结论：你写的这个Schema完全无效，这就是你看到Error: Field "Query.user" can only be defined once.错误的原因——GraphQL的Query类型里不允许重复定义同名字段，哪怕参数列表不一样也不行，这是GraphQL Schema的基本规则。

接下来给你两种解决需求的方案，以及针对你补充问题的解答：

方案1：用不同名称的查询字段（最推荐） #

这是最直观也最符合GraphQL设计理念的方式，直接把两个查询逻辑拆成不同的字段，调用方一眼就能明白该用哪个：

const typeDefs = gql`
type Query {
  userByUsername(username: String!): User
  userByEmail(email: String!): User
}
`;

这种方式不需要额外的校验逻辑，每个字段的参数都是必填的，完全避免了歧义，也能完美支持你“通过用户名或邮箱查询用户”的需求，甚至能同时处理你提到的“某个用户邮箱是另一个用户用户名”的场景——调用方明确指定用哪个维度查询，就不会出错。

方案2：单字段+Resolver参数校验（适合保留统一字段名的场景） #

如果你坚持想要用同一个user字段来实现，那可以把两个参数都设为可选，但必须在Resolver里手动校验必须且只能传其中一个参数：

首先是Schema定义：

const typeDefs = gql`
type Query {
  user(username: String, email: String): User
}
`;

然后在Resolver中添加校验逻辑（以JavaScript为例）：

const resolvers = {
  Query: {
    user: async (_, { username, email }, { db }) => {
      // 校验参数：必须二选一
      const hasUsername = Boolean(username);
      const hasEmail = Boolean(email);
      
      if (!hasUsername && !hasEmail) {
        throw new Error("请提供用户名或邮箱中的一个");
      }
      if (hasUsername && hasEmail) {
        throw new Error("不能同时提供用户名和邮箱");
      }
      
      // 根据参数查询用户
      return hasUsername 
        ? db.user.findUnique({ where: { username } })
        : db.user.findUnique({ where: { email } });
    }
  }
};

这种方式能保留统一的字段名，但缺点是Schema本身无法体现“二选一”的约束，调用方需要依赖文档才能知道规则，不如方案1清晰。

关于你补充的问题 #

当你把Schema定义为user: User(username: String, email: String)时，GraphQL本身不会自动确保恰好一个参数不为空——默认情况下，两个参数都可以不传，或者同时传，这就会出现逻辑歧义（比如你说的特殊场景，同时传的话到底查哪个用户？）。所以必须通过Resolver里的手动校验来实现“恰好一个不为空”的约束，就像方案2里的代码那样。

内容的提问来源于stack exchange，提问作者J. Stott