React中使用Firebase与Context API实现认证的useEffect依赖及重复执行问题
你遇到的重复执行、依赖警告问题,本质是三个常见代码疏漏导致的,和useEffect的依赖规则没有冲突:
- Context向外传递值时没有做引用记忆化,导致解构出来的
setUserInfo引用每次渲染都变化,触发useEffect无意义的重复执行 - 绑定Firebase认证状态监听时没有配套清理逻辑,旧监听得不到释放,多个监听同时存活就会重复触发setUserInfo
- 开发环境下React 18默认开启的StrictMode会双执行effect逻辑,用来提前暴露内存泄漏、重复绑定的问题,会放大上面两个疏漏的影响,这不是生产环境的真实运行行为
1. 固定Context传递值的引用稳定性
绝大多数人写Context的时候会直接把状态和setter包在临时对象里传递,这是导致引用不稳定的核心原因:
// 常见反例:每次组件重渲染都会生成全新的value对象,打破引用稳定性 const [userInfo, setUserInfo] = useState({ jwtToken: null }) return ( <userInfoContext.Provider value={{ userInfo, setUserInfo }}> {children} </userInfoContext.Provider> )
这种写法下,哪怕setUserInfo本身是useState返回的天生稳定的函数,因为它被包在全新的对象里向外传递,解构出来的setUserInfo也会随每次渲染变成新的引用,让useEffect误以为依赖发生了变化,重新执行绑定逻辑。
修正方式是用useMemo对传递的value做记忆化,保证引用固定:
// 修正后的稳定Provider写法 const [userInfo, setUserInfo] = useState({ jwtToken: null }) // 仅在userInfo变化时才生成新的value对象,保证传递出去的setUserInfo引用永远不变 const contextValue = useMemo(() => ({ userInfo, setUserInfo }), [userInfo]) return ( <userInfoContext.Provider value={contextValue}> {children} </userInfoContext.Provider> )
做完这一步,你在App中解构得到的setUserInfo会是固定不变的引用,不会再无故触发useEffect重跑。
2. 给Firebase认证监听加配套清理逻辑
auth.onAuthStateChanged被调用后,会返回一个取消订阅的函数,如果不把这个函数作为effect的清理逻辑返回,任何原因导致effect重新执行时,旧的监听得不到释放,就会出现多个监听同时触发setUserInfo的问题。
修正你的useEffect代码,补上清理环节,同时避开Firebase的私有字段坑:
const { setUserInfo } = useContext(userInfoContext); useEffect(() => { // 接收onAuthStateChanged返回的取消订阅函数 const unsubscribe = auth.onAuthStateChanged(user => { if (user) { // 注意:不要用user.za这个内部压缩字段,Firebase版本迭代后这个字段名随时可能变化 // 直接使用公开的accessToken即可,需要获取最新令牌时调用user.getIdToken() setUserInfo({ jwtToken: user.accessToken }); } else { setUserInfo({ jwtToken: null }); } }); // 组件卸载、effect重新执行前,自动取消上一次的监听 return unsubscribe; }, [setUserInfo]);
这种写法下,哪怕遇到开发环境的StrictMode双执行机制,第一次执行绑定的监听会在第二次执行前被自动清理,最终只会留下一个有效的认证监听,不会出现重复调用setUserInfo的情况。StrictMode的双执行逻辑是React专门用来帮开发者提前发现未做清理的内存泄漏问题,生产环境下不会触发。
3. 消除ESLint警告
做完上面两步后,你把setUserInfo放在useEffect的依赖数组里是完全符合Hooks规范的:
- 因为Provider做了记忆化,
setUserInfo的引用永远稳定,不会无故触发effect重跑 - 监听的清理逻辑已经完备,哪怕开发环境有双执行机制也不会产生副作用
此时ESLint的react-hooks/exhaustive-deps警告会自动消失,不需要手动加注释屏蔽规则。
你选择将JWT存在Context的内存状态中、不存入localStorage的设计是合理的,这种方式能避免XSS恶意脚本直接读取令牌,降低认证信息泄露的风险,同时也不需要引入额外的状态管理库,和你目前不使用Redux的规划完全适配。
内容的提问来源于stack exchange,提问作者AM13

