useMutation传参异常：必填参数_id未提供问题排查

问题重现 #

我定义了如下GraphQL mutation：

const UPDATE_UNIT_HOTLIST = gql`
  mutation unitUpdateById($unit_id: String!, $hot_list: Boolean!, $user_id: String!) {
    unitUpdateById(_id: $unit_id, user_id: $user_id, hot_list: $hot_list) {
      _id
      hot_list
    }
  }
`

const [unitUpdateById] = useMutation(UPDATE_UNIT_HOTLIST)

const formattedData = {
  unit_id: unit.id,
  hot_list: !isHotlist,
  user_id: sessionStorage.USER_ID,
}

unitUpdateById({
  variables: formattedData,
})

但始终收到如下错误提示：

message: "Field "unitUpdateById" argument "_id" of type "String!" is required, but it was not provided."

明明已经传入数据，却报错说_id未提供，问题出在哪里？

问题原因及解决方法 #

出现这个错误的核心原因是你传入的unit_id变量值为空（或undefined），导致GraphQL服务器认为_id参数未被正确提供。具体排查方向：

• 检查unit.id是否有效
  在调用unitUpdateById前添加日志，确认unit对象是否存在、unit.id是否有实际值：

  console.log('unit对象:', unit);
  console.log('unit.id:', unit.id);
  

  如果unit是undefined，说明你在获取这个对象时可能存在异步未完成、数据未加载的情况；如果unit.id为空字符串或null，需要确认数据来源是否正确。

• 确认sessionStorage.USER_ID的有效性
  虽然错误提示指向_id，但如果user_id为空也可能触发服务器端的参数校验问题，同样可以通过日志确认：

  console.log('USER_ID:', sessionStorage.USER_ID);
  

• 检查变量传递的拼写一致性
  你的mutation定义中变量名是$unit_id，formattedData里的键名也是unit_id，这部分是正确的，但可以再次确认没有拼写错误（比如大小写、多写少写字母）。

额外建议 #

如果是异步场景下获取unit数据（比如从接口请求、状态管理中获取），要确保在unit数据加载完成后再调用unitUpdateById，比如用条件判断包裹：

if (unit?.id) {
  unitUpdateById({
    variables: formattedData,
  })
}

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