You need to enable JavaScript to run this app. React中useEffect返回函数无法清除addEventListener事件监听器问题
优惠活动
大模型
产品
解决方案
定价
更多

React中useEffect返回函数无法清除addEventListener事件监听器问题

事件监听器移除失效的根因

  1. 你当前贴出的代码中useEffect没有传入第二个依赖数组参数,这会导致每一次组件重渲染都会重复执行useEffect逻辑:先移除上一次渲染周期注册的监听器,再注册新的监听器,看起来就像监听器从来没有被清除。
  2. 就算传入空依赖数组后仍然失效,通常是两个场景导致:
    • React 18+ 开发环境开启了严格模式(<StrictMode>),为了校验副作用清理逻辑的完整性,会在组件首次挂载时额外执行一次「卸载→重挂载」流程,会出现两次注册监听器的现象,该行为仅存在于开发环境,生产环境不会触发。
    • 组件实际没有被卸载,导致useEffect的清理函数从来没有执行。

修复方案

  • 给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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.09 18:57:00