优质GraphQL查询模式解析：两种用户查询方案对比

假设场景：id和email字段均保证唯一，以下是两种常见的查询用户数据的GraphQL模式：

模式一：按查询名称区分参数类型 #

通过不同的查询名称明确指定使用的参数，示例代码：

getUserById(id)
getUserByEmail(email)

模式二：单查询兼容多类型参数 #

使用同一个查询接口，通过传入不同的参数字段来执行查询，解析器（resolver）会自动选择对应字段的查询逻辑，示例代码：

getUser({ id })
getUser({ email })

模式二的优缺点 #

优点

• 兼容多种查询类型，后续新增查询字段时更灵活，不用额外创建新的查询接口
• 仅需维护一个查询接口，消费者不用查找多个不同的查询名称，理解起来更简单
• 如果消费者需要动态切换查询依据（比如从用id查询改成用email查询），不用重新编写全新的查询语句

缺点

• 必须在解析器中手动处理参数验证逻辑（比如确保传入且仅传入一个有效查询参数）
• 会提升解析器的后端实现复杂度，需要处理多种参数分支的查询逻辑

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