无效 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 使用