React中useEffect返回函数无法清除addEventListener事件监听器问题
事件监听器移除失效的根因
- 你当前贴出的代码中
useEffect没有传入第二个依赖数组参数,这会导致每一次组件重渲染都会重复执行useEffect逻辑:先移除上一次渲染周期注册的监听器,再注册新的监听器,看起来就像监听器从来没有被清除。 - 就算传入空依赖数组后仍然失效,通常是两个场景导致:
- React 18+ 开发环境开启了严格模式(
<StrictMode>),为了校验副作用清理逻辑的完整性,会在组件首次挂载时额外执行一次「卸载→重挂载」流程,会出现两次注册监听器的现象,该行为仅存在于开发环境,生产环境不会触发。 - 组件实际没有被卸载,导致useEffect的清理函数从来没有执行。
- React 18+ 开发环境开启了严格模式(
修复方案
- 给useEffect传入空依赖数组
[],确保监听器仅在组件挂载时注册一次,组件卸载时才执行清理:
import React, { useEffect } from "react"; import headerLogo from "./icons/logo.svg"; import { useHistory } from "react-router-dom"; function Home({ header }) { const history = useHistory(); useEffect(() => { const mouseClickListener = (e) => { e.preventDefault(); console.log("LISTENING"); history.push("/dashboard"); }; window.addEventListener("click", mouseClickListener); return () => window.removeEventListener("click", mouseClickListener); }, []); // 新增空依赖数组,仅挂载/卸载时执行一次 return ( <div className={`${header ? "header-logo" : "home-logo"}`}> <img src={headerLogo} alt="logo" /> </div> ); } export default Home;
- 可以在清理函数中新增日志,确认组件卸载时清理逻辑是否正常执行,如果日志没有打印,说明你的业务逻辑中Home组件没有被正常卸载,需要排查上层路由/组件的渲染逻辑。
- 如果你注册监听器时传入了第三个配置参数(比如
{capture: true}/{once: true}),移除监听器时必须传入完全相同的配置参数,否则会移除失败。
内容的提问来源于stack exchange,提问作者A1I
相关产品推荐
相关产品推荐

