React / 系统课时

排查常见 React 问题

排查常见 React 问题

这节建立一条可重复使用的排查路径,集中处理四类高频故障:无限渲染、状态不同步、Effect 依赖错误和列表 key 异常。目标不是背报错,而是从触发点反推根因。

学习目标

  • 根据报错和触发动作定位无限更新来源
  • 区分“需要存储的状态”和“可以直接推导的值”
  • 正确处理 Effect 依赖与列表实例身份

先按现象缩小范围

看到 Too many re-renders 或 Maximum update depth exceeded,优先检查渲染阶段是否直接调用 setter,以及 Effect 是否在修改自己的依赖。若页面只在快速连续更新后数值不对,则重点检查是否使用了旧闭包中的 state。

如果问题表现为输入后副作用没有更新,或 lint 提示依赖缺失,检查 Effect 实际读取了哪些外部值。若列表输入框、动画或局部状态“跑到另一行”,检查 key 是否使用了数组索引、随机数或会变化的字段。

现象 常见根因 优先修复
渲染后立刻死循环 渲染阶段更新 state,或 Effect 自我触发 把更新移到事件中,重新设计 Effect
连续更新少了一次 使用旧 state 计算新 state 使用函数式更新
Effect 读取旧值 依赖数组缺项 补齐真实依赖或重构副作用
列表局部状态串行 key 不稳定 使用稳定且唯一的业务 ID

用一个组件验证四个修复原则

下面的组件不保存能够由现有状态推导出的“过滤结果”,从源头避免额外同步;连续加二使用函数式更新;Effect 明确依赖 query;列表使用稳定的 id 作为 key。

jsx
import { useEffect, useState } from "react";

const tasks = [
  { id: "render", title: "排查无限渲染" },
  { id: "state", title: "修复状态不同步" },
  { id: "deps", title: "检查 Effect 依赖" },
];

export default function App() {
  const [query, setQuery] = useState("");
  const [count, setCount] = useState(0);

  const visibleTasks = tasks.filter((task) =>
    task.title.toLowerCase().includes(query.toLowerCase())
  );

  useEffect(() => {
    // Effect 使用了 query,因此依赖数组必须包含 query。
    document.title = query ? `搜索:${query}` : "React 排查";
  }, [query]);

  function addTwo() {
    // 新值依赖旧值时使用函数式更新,连续两次会可靠地加 2。
    setCount((current) => current + 1);
    setCount((current) => current + 1);
  }

  return (
    <main>
      <label>
        关键词
        <input
          value={query}
          onChange={(event) => setQuery(event.target.value)}
        />
      </label>

      <button onClick={addTwo}>计数 +2</button>
      <p>计数:{count}</p>

      <ul>
        {visibleTasks.map((task) => (
          <li key={task.id}>{task.title}</li>
        ))}
      </ul>
    </main>
  );
}

预期结果:

text
初始时显示 3 条任务,计数为 0。
点击“计数 +2”一次后显示“计数:2”。
输入“状态”后只保留“修复状态不同步”。
浏览器标题随 query 改变,控制台不出现无限更新错误。

无限渲染先找“谁在更新谁”

渲染函数必须保持纯计算。若组件在渲染期间执行 setCount(count + 1),每次渲染都会再次安排更新,循环不会结束。另一种常见情况是 Effect 依赖 items,同时又执行 setItems([...items]);新数组身份每次都不同,于是 Effect 持续重跑。

修复时不要只删除依赖来“压住”报错。先判断这次 state 更新是否真的需要:能从 props 或其他 state 直接算出的值应在渲染时推导;必须由用户动作触发的更新放进事件处理器;真正同步外部系统的逻辑才放进 Effect。

依赖与 key 都是在维护身份

Effect 的依赖数组描述“哪些值变化时需要重新同步外部世界”。只要 Effect 读取了组件作用域中的响应式值,就应默认把它列为依赖;如果加入后导致频繁执行,问题通常是对象或函数每次渲染都被重新创建,而不是依赖规则本身有错。

列表 key 则描述“这一行前后是不是同一个实例”。最可靠的是数据库 ID、业务 ID 等稳定标识。key={index} 只适合顺序永远不变的静态列表,key={Math.random()} 会让 React 每次都把元素当成新实例,容易造成输入焦点、局部 state 与动画状态丢失。

用固定顺序收敛问题

排查时先复现最小触发动作,再读取第一条有效报错,然后确认是哪次事件或 Effect 触发 state 更新。接着检查该值是否应该存成 state,最后再核对 Effect 依赖和列表 key。按照这个顺序,四类看似不同的问题都会落到同一个核心:不要制造不必要的状态,并让更新时机和实例身份保持稳定。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

排查常见 React 问题

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通