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。
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>
);
}预期结果:
初始时显示 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。按照这个顺序,四类看似不同的问题都会落到同一个核心:不要制造不必要的状态,并让更新时机和实例身份保持稳定。