Skip to content

无效 Hook 调用:在函数组件外调用

快速摘要

你在函数组件外或条件内调用了 hook —— React 要求 hook 在组件顶层调用。

为什么发生

  • 你在非 React 组件的普通 JavaScript 函数中调用了 hook

  • 你在条件、循环或嵌套函数中调用了 hook,违反 hooks 规则

  • 你在类组件方法中调用了 hook,这不受支持 —— hook 只在函数组件中工作

最小示例

✗ 错误代码
function useUserData(userId) {
  if (userId) {
    const [data, setData] = useState(null); // conditional hook!
  }
  return data;
}
✓ 修复代码
function useUserData(userId) {
  const [data, setData] = useState(null); // always called
  useEffect(() => {
    if (userId) fetchUser(userId).then(setData);
  }, [userId]);
  return data;
}

将 hook 调用移到顶层确保每次渲染无条件调用,遵循 hooks 规则。

如何诊断

  • 检查错误信息中的 'Invalid hook call',表示 hook 在组件外使用

  • 验证 hook 在函数组件顶层调用,不在条件或循环内

  • 使用 eslint-plugin-react-hooks 的 rules-of-hooks 规则检测无效 hook 使用

如何修复

  • 将 hook 调用移到函数组件顶层,在任何条件之前

  • 如果需要使用 hook 则将类组件转换为函数组件

  • 将 hook 提取为自定义 hook(以 'use' 开头的函数),从组件中调用

如何预防

  • 只在函数组件或自定义 hook 顶层调用 hook —— 永远不在条件或循环内

  • 启用 rules-of-hooks eslint 规则在构建时捕获无效 hook 使用

相关资源

相关术语

相关课程

← 返回语言