React useEffect 详解:依赖、清理、重复执行与请求竞态

写 React 页面时,useEffect 常被当成"组件加载后执行一段代码"的工具。但只记住这句话,遇到切换用户后显示旧数据、开发环境请求两次、依赖一加就循环时,往往不知道该从哪里查起。

更准确的理解是:Effect 让组件与 React 之外的系统保持同步。这个外部系统可以是网络请求、浏览器事件、定时器、连接或第三方组件。本文从它何时启动、何时清理开始,讲清依赖数组和常见故障,再用一个可复现的用户资料页示例串起来。

先分清三种代码:渲染、事件和 Effect

组件函数里的渲染代码负责根据 props、state 计算界面。点击按钮后才应该发生的动作,放在事件处理函数。显示这个组件期间必须与外部系统保持一致的动作,才适合 Effect。

例如,点击"提交订单"发起 POST,应放在提交事件里。如果把它放进 useEffect,组件重新出现、依赖变化或开发环境的检查都可能触发重复提交。反过来,组件显示时需要订阅在线状态,离开时要取消订阅,这就是 Effect 的典型用途。React 官方将 Effect 描述为与外部系统同步的机制,而不是通用的"渲染后回调"。React:Synchronizing with Effects

jsx 复制代码
function OrderButton({ order }) {
  async function handleSubmit() {
    await fetch('/api/orders', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify(order),
    });
  }

  return <button onClick={handleSubmit}>提交订单</button>;
}

上面只是演示"由点击触发的动作放在哪里";实际项目还应处理按钮禁用、重复提交、服务端幂等和错误展示。不要把这些业务保障误以为 Effect 能自动提供。

Effect 的执行顺序:启动、清理、再启动

看一个订阅房间消息的例子。roomId 变化时,原来的房间连接不能继续留着;组件移除时,也不能留下一条无人使用的连接。

jsx 复制代码
import { useEffect } from 'react';

function ChatRoom({ roomId }) {
  useEffect(() => {
    const connection = createConnection(roomId);
    connection.connect();

    return () => connection.disconnect();
  }, [roomId]);

  return <h2>当前房间:{roomId}</h2>;
}

这段代码表达的不是"组件只挂载一次"。它表达的是:当前 roomId 对应一段同步过程。初次提交后建立连接;之后若一次提交使 roomId 改变,先执行上一次 Effect 返回的清理函数 ,再用新值建立连接;组件卸载时,最后再清理一次。React:useEffect

因此,清理函数不只是"卸载回调"。它还负责阻止旧同步过程干扰新同步过程。订阅要退订,定时器要清除,连接要断开,异步请求的旧结果要取消或忽略。每个 Effect 最好只承担一个独立的同步任务,便于核对启动与清理是否成对。

依赖数组到底控制了什么

依赖数组告诉 React:哪些响应式值 变化后,当前 Effect 需要重新同步。props、state,以及组件函数中声明并在 Effect 内读取的变量或函数,都属于需要考虑的响应式值。React 会用 Object.is 比较本次与上次的各项依赖。React:useEffect

写法 触发方式 常见用途
useEffect(setup) 每次提交后都执行清理和新 setup 确实需要每次提交同步时;通常要仔细检查是否过度执行
useEffect(setup, []) 初次提交后执行;卸载时清理 不读取会变化的组件值的同步任务
useEffect(setup, [roomId]) 初次提交后执行;roomId 变化的提交后清理并重建 与房间 ID 等特定值同步

这里的"提交"指 React 把本次渲染结果应用到界面,不等同于组件函数每调用一次就执行一次 Effect。未提交的渲染不会让 Effect 启动。更重要的是,[] 不代表"整个应用生命周期只执行一次":组件可以卸载再挂载,开发环境的 Strict Mode 也会额外检查启动和清理。React:Lifecycle of Reactive Effects

为什么不能为了消除警告直接删依赖

假设 roomId 从 general 变成 support,Effect 内仍读取 roomId,依赖却写 []。React 认为它不用重新同步,连接可能继续停留在旧房间。这就是典型的旧值问题。正确做法是把实际读取的响应式值列全,或改变代码结构,让它真的不再依赖该值。

另一个方向的问题是对象与函数。每次渲染创建的 { roomId } 是新对象;若把它作为依赖,Object.is 比较会发现身份不同,Effect 可能每次都重新连接。通常可以把对象创建移入 Effect,再只依赖稳定的 roomId 原始值;不应把关闭 exhaustive-deps 检查当成修复。React:Removing Effect Dependencies

jsx 复制代码
function ChatRoom({ roomId }) {
  useEffect(() => {
    const options = { roomId, serverUrl: 'wss://example.invalid' };
    const connection = createConnection(options);
    connection.connect();
    return () => connection.disconnect();
  }, [roomId]);

  return <h2>{roomId}</h2>;
}

上面的地址仅是示意值,不是可连接服务。关键是让依赖反映真实输入,而不是依赖每次渲染都重建的包装对象。

从一次用户切换看完整过程

设想资料页先显示用户 A,再快速切到用户 B。A 的请求发出在前,却可能返回在后。若两个请求都能写入同一份 state,页面就可能显示"选中 B,内容却是 A"。Effect 的清理恰好提供了处理旧请求的时机。

图里最值得注意的不是"发两次请求",而是两个同步过程有各自的有效期。A 的 Effect 因用户切换结束,B 的 Effect 才开始;即便网络层仍有 A 的回应,旧过程也不能再修改当前界面。图中的清理箭头指向旧过程,新的请求只属于 B。这个顺序能同时解释退订、清定时器和请求竞态。

一个可复现的资料页示例

以下是 React 函数组件示例,假定后端提供 GET /api/users/:id,成功返回 { "id": "...", "name": "..." }。示例未在当前环境运行;读者可放入 React 项目,配合浏览器开发者工具验证。AbortController 负责尝试取消旧请求,ignore 标记则进一步防止旧异步分支在清理后写入 state。

jsx 复制代码
import { useEffect, useState } from 'react';

export default function UserProfile({ userId }) {
  const [profile, setProfile] = useState(null);
  const [error, setError] = useState('');
  const [loading, setLoading] = useState(false);

  useEffect(() => {
    if (!userId) {
      setProfile(null);
      setError('');
      setLoading(false);
      return;
    }

    const controller = new AbortController();
    let ignore = false;
    setProfile(null);
    setError('');
    setLoading(true);

    async function loadProfile() {
      try {
        const response = await fetch(
          `/api/users/${encodeURIComponent(userId)}`,
          { signal: controller.signal },
        );
        if (!response.ok) throw new Error(`HTTP ${response.status}`);
        const data = await response.json();
        if (!ignore) setProfile(data);
      } catch (err) {
        if (!ignore && err.name !== 'AbortError') {
          setError(err.message || '请求失败');
        }
      } finally {
        if (!ignore) setLoading(false);
      }
    }

    loadProfile();
    return () => {
      ignore = true;
      controller.abort();
    };
  }, [userId]);

  if (!userId) return <p>请选择用户</p>;
  if (loading) return <p>正在加载...</p>;
  if (error) return <p role="alert">{error}</p>;
  return <p>{profile?.name ?? '暂无资料'}</p>;
}

这里有四个容易忽略的点。第一,userId 是 Effect 读取的响应式值,必须是依赖。第二,切换 ID 时先清空旧资料,避免新请求进行中仍展示旧人信息。第三,HTTP 非 2xx 不会让 fetch 自动抛错,所以要检查 response.ok。第四,清理同时设置 ignore 并调用 abort():取消请求能减少无用工作,忽略标记则给后续状态写入再加一道边界。React 官方的资料加载示例也强调取消或忽略旧结果。React:Synchronizing with Effects

怎样验证竞态确实被处理了

在浏览器开发者工具 Network 里把请求调慢,先选择 A,立刻切换 B。观察 A 的请求被取消或其结果被忽略,最终页面只能显示 B 的资料。再切回 A,确认能重新加载。离开页面时,检查是否还有旧请求造成状态更新。开发环境若开启 Strict Mode,初次挂载可能看到额外的请求与清理;不要用"只允许执行一次"的 ref 掩盖缺失的清理。

如果请求库没有支持取消的接口,至少让清理函数把 ignore 设为 true,并在所有会写入界面状态的异步分支前检查它。对于跨组件缓存、预取、服务端渲染或复杂重试,更适合交给框架的数据加载机制或专门的数据请求库,而不是在每个组件里重复手写 Effect。React 官方也提醒,直接在 Effect 里手工取数有网络瀑布、缓存不足等局限。React:useEffect

为什么开发环境会执行两次

开启 Strict Mode 时,React 在开发环境会额外执行一次 setup → cleanup → setup,用来暴露"只建立不清理"的问题。你可能看到连接日志出现两次,或 Network 里有额外请求。这不意味着生产环境会按相同方式额外执行,也不意味着应该用一个 ref 强行拦截第二次执行。React:Synchronizing with Effects

判断标准是:经过一次 setup → cleanup → setup 后,最终外部状态应与一次正常 setup 一致。例如连接数量仍是一条,事件监听器仍是一个,旧请求不会覆盖新资料。若清理后仍遗留连接,问题在同步过程不对称,而不是 Strict Mode "乱执行"。

三类常见故障,按现象定位

无限重复执行。 Effect 设置了某个 state,而这个 state 的变化又改变依赖;或依赖里放了每次渲染新建的对象、函数。先找出是哪项依赖变化,再看状态更新是否根本无需 Effect。计算展示数据时,直接在渲染期间计算,通常比"Effect 算完再 setState"清楚。React:You Might Not Need an Effect

旧数据覆盖新数据。 多个异步工作同时存在,旧工作没有在依赖变化时失效。按上面的资料页方式,给每次 Effect 的异步工作设置独立取消或忽略机制,并确保错误、加载结束等分支也不更新已失效的工作。

资源泄漏或重复订阅。 Effect 建立监听器、定时器或连接,却没有返回对应清理函数。查组件卸载和依赖变化两个时点,确认清理的是本次 setup 创建的那一个资源。

排查时先看现象落在哪条路径。例如输入框每敲一个字就重新连接,先找新建对象或函数是否被当成依赖;快速切换用户后资料错位,先查旧请求是否还能写 state;页面来回切换后消息出现多份,再查退订与断开连接是否与建立过程一一对应。底部的"没有外部系统"是最后一道判断:如果只是计算展示值,根本不需要从这三条 Effect 路径中找补丁。

还有一种"故障"其实是工具选错:若只是把 firstName 和 lastName 拼成 fullName,不涉及外部系统,就直接在渲染期间计算。若只因点击按钮才发出动作,就放在事件处理函数。Effect 用得越少,真正需要同步外部系统的 Effect 越容易看清。

最后记住一条主线

读 useEffect 时,不妨每次问三件事:它同步了哪个外部系统?哪些响应式输入会让同步失效?清理函数怎样结束旧同步? 这三个问题能解释依赖、清理、开发环境重复执行和请求竞态,也能帮助你判断一段代码根本不需要 Effect。

参考资料

相关推荐
典学长编程6 天前
Agent 基础学习:让大模型从“能说”到“会做”
agent·react·text2sql·工具调用
2601_9679791214 天前
2024年前端开发趋势与最佳实践
框架·前端开发·工具·最佳实践·趋势
JudithHuang15 天前
React 嵌套路由与布局
前端·react.js·arcgis·react·react router
2601_9679873718 天前
Next.js 全栈开发入门指南(2026 最新版)
react·next.js·全栈开发·企业级开发·渲染模式
2601_9679873718 天前
完整教程:Next.js项目演示(从零创建Next.js项目)Next.js入门实战
react·教程·前端开发·next.js·项目创建
goehou19 天前
ReAct 循环跑偏的三种样子,以及怎么在工程上兜住
llm·agent·react·工具调用·工程实践
大连好光景20 天前
ClaudeCode有关Agent Loop知识点大全
react·max_turns·agentloop·checkpoint快照·流式输入
汤米粥20 天前
2026年主流前端技术框架
vue·react·elementplus·tailwind css·angular‌·svelte‌·bootstrap‌