GraphQL查询单条记录报错：‘Unknown argument "name"’求助

首先咱们先抓准问题核心：你本地跑CRUD功能完全正常，但部署到Heroku的服务器上，users字段并不支持name这个参数——这说明线上的GraphQL Schema和你本地的版本不一致。下面给你一步步排查解决的思路：

1. 核对本地与线上的Schema定义 #

先打开本地项目里的GraphQL Schema文件（可能是.graphql后缀，或是代码里写的SDL定义），找到Query类型下的users字段。你本地的定义应该是支持name参数的，比如：

type Query {
  users(name: String): [User!]!
  # 其他查询字段...
}

但线上部署的Schema里，users字段大概率没加这个参数，比如：

type Query {
  users: [User!]!
  # 其他查询字段...
}

这就直接导致你带name参数查询时触发报错。

2. 检查Heroku部署的代码是否同步 #

最大的可能是你本地修改了Schema，但没把最新代码推送到Heroku。按以下步骤操作：

• 先确认本地代码的Schema修改已经提交：用git status查看未提交文件，用git add+git commit完成提交。
• 重新推送到Heroku：执行git push heroku main（如果你的主分支是main，换成你实际的分支名即可）。
• 推送完成后重启Heroku服务器：heroku restart，确保新的Schema生效。

3. 确认是否混淆了列表查询与单条查询 #

另外有些教程会把「查询单条用户」定义为单数的user，而复数的users是查询全量用户、不带过滤参数，比如：

type Query {
  users: [User!]! # 查询所有用户
  user(name: String): User # 根据name查询单条用户
}

如果是这种情况，你应该切换成单条查询的语句：

{
  user(name: "eee") {
    id
    name
  }
}

你可以直接在Heroku的GraphQL IDE右上角点「Docs」按钮，查看官方Schema文档，确认users和user各自支持的参数，就能明确正确的查询写法了。

4. 验证修改后的效果 #

等代码推送完成、服务器重启后，回到Heroku的GraphQL IDE重新执行查询，应该就能正常拿到数据了。

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