普通函数getMyMenu调用useTranslation触发React Hook规则报错如何解决
问题根因
- 该报错是React Hook 的强制校验规则触发的:React Hook 有明确的调用边界,只能在两类场景下被调用:一是React函数组件的函数体顶层,二是以
use为前缀的自定义Hook内部。 - 你定义的
getMyMenu是普通的递归路由处理工具函数,既不符合自定义Hook的命名要求,也不是React组件,因此会被ESLint的react-hooks/rules-of-hooks规则拦截报错。
其他项目相同写法能运行的原因
这类可运行的场景并不代表写法合规,通常是两个原因导致的假象:
- 对应项目关闭了
eslint-plugin-react-hooks的语法校验规则,没有对违规的Hook调用做拦截 - 业务场景没有触发隐性bug:你的递归逻辑存在分支判断,如果某层路由节点不满足
showRoute条件,getMyMenu就会提前返回、不执行内部的useTranslation调用,这会导致不同渲染周期下Hook的调用顺序不一致,最终出现状态错乱、渲染崩溃的问题,只是没有被实际业务场景触发到而已。
合规的修正方案
核心原则是不要把Hook调用嵌入递归遍历的普通工具函数内,将Hook调用上移到组件顶层即可:
- 改造路由处理函数,把翻译函数
t作为入参传入,移除函数内部的useTranslation调用 - 在
MyNav组件的顶层位置调用一次useTranslation,拿到t实例后通过闭包或bind传给递归处理流程 - 参考修正代码:
import { useTranslation } from "react-i18next"; // 普通处理函数不再调用Hook,接收t作为参数 function getMyMenu(t, a) { if (a.showRoute) { a.label = t(a.label); return a; } } export const MyNav = props => { // Hook仅在组件顶层调用一次,完全符合调用规则 const { t } = useTranslation('translations'); // 预先绑定t参数,生成适配recurseFn入参要求的处理函数 const routeHandler = getMyMenu.bind(null, t); let tabs = recurseFn(routeHandler, props.routes); // 原代码缺失返回值逻辑,此处需补充 return tabs; }
注意:不要为了绕开校验规则把
getMyMenu改成use开头的命名来骗过ESLint。这类写法哪怕通过了语法校验,只要递归过程中存在分支跳过Hook调用的逻辑,依然会触发React运行时的Hook顺序错乱问题,产生无法排查的隐性bug。
内容的提问来源于stack exchange,提问作者copenndthagen
相关产品推荐
相关产品推荐

