React 基础错误
50 个错误
React 常见错误排查手册:Hooks 规则、渲染死循环、Key 警告等问题的成因分析与修复方案。
50 / 50
- 1
ReferenceError: 组件是 不定义
你 referenced 组件 in JSX 但它 是从不 imported or declared, 所以 JavaScript doesn't know 什么它 是.
- 2
错误: 无效 Hook call
你 called React Hook (useState, useEffect, etc.) 之外函数组件 or another Hook, 哪个 violates 规则的 Hook.
- 3
错误: React Hook 是 called conditionally
你 placed Hook call 内部如果语句 or other conditional, 哪个 breaks React's ability 到 track Hook 顺序跨越渲染.
- 4
警告: 每个 child in 列表应该有 唯一键 prop
你 rendered 列表的 元素不使用 providing 唯一 `键` prop 到每个项, 哪个 prevents React 从 efficiently tracking 项.
- 5
警告: 能't 执行 React 状态更新 on unmounted 组件
异步操作 (获取, setTimeout, Promise) 已完成之后组件 unmounted and tried 到 call setState, indicating memory leak.
- 6
TypeError: Cannot 读取属性的 undefined (读取 '映射')
你 called `.映射()` on 变量那个是 `undefined` — 通常因为数据 hasn't 加载 yet or prop wasn't 通过.
- 7
错误: 对象是 不有效 as React child
你 placed JavaScript 对象 directly in JSX 哪里 React expects 字符串, 数字, or React 元素.
- 8
错误: 最大值更新深度 exceeded
组件是 stuck in 无限循环的 状态更新 and re-渲染, 通常因为 setState 是 called 期间渲染 or in useEffect 使用错误 dependencies.
- 9
SyntaxError: Adjacent JSX 元素必须是 wrapped in enclosing 标签
组件 tried 到返回多个 sibling JSX 元素不使用 wrapping 它们 in parent 元素 or 片段.
- 10
警告: React Hook useEffect 有 missing dependency
你的 useEffect 引用变量那个 isn't in 它的 dependency 数组, 哪个能 cause 副作用到 use stale 值.
- 11
警告: Cannot 更新组件虽然渲染不同组件
组件 called setState on 不同组件期间渲染 phase, 哪个 React 做不 允许.
- 12
ReferenceError: React 是不 定义
JSX 需要 React 到是 in 作用域 (in older setups) or automatic JSX 运行时到 是配置. 这个错误平均值 neither 是 satisfied.
- 13
Bug: useState 不更新 UI
你 mutated 状态 directly 相反的 calling setter 使用新 值, 所以 React didn't detect 更改 and didn't re-渲染.
- 14
错误: 也许多 re-渲染. React 限制数字的 渲染到 prevent 无限循环
你 called 状态 setter 函数 directly in 组件请求体 (不 in 事件处理函数 or 副作用), causing 无限渲染循环.
- 15
警告: 组件是 更改 controlled 输入到 是 uncontrolled
输入's `值` prop 更改从 定义值 到 `undefined` (or 空), 切换它 从 controlled 到 uncontrolled.
- 16
Bug: useEffect cleanup 不运行
cleanup 函数 returned 从 useEffect 是不 运行, 通常因为它 wasn't returned or 副作用有 错误 dependencies.
- 17
警告: 函数组件 cannot 有字符串 refs
你 used 字符串 ref (e.g., `ref="myRef"`) on 函数组件, 哪个是 legacy API 不 supported in 函数组件.
- 18
警告: React.createElement: 类型是 无效 -- expected 字符串 or 函数/组件但 获取: undefined
你 rendered `<SomeComponent />` 但 `SomeComponent` 是 undefined, 经常 due 到默认/named 导出 mismatch.
- 19
Bug: Stale 闭包 — 事件处理函数 uses 旧状态值
事件处理函数创建 in 上一个渲染 captures 状态值 从那个渲染, 不 current one.
- 20
警告: Support for defaultProps 将是 移除从 函数组件
你设置 `组件.defaultProps` on 函数组件, 哪个是 deprecated. Use JavaScript 默认参数相反.
- 21
警告: ReactDOM.findDOMNode 是 deprecated and 将是 移除
你 called `ReactDOM.findDOMNode()` 哪个是 deprecated. Use refs attached 到 DOM 元素相反.
- 22
警告: componentWillMount 有是 renamed
你 used deprecated unsafe lifecycle 方法 (componentWillMount, componentWillReceiveProps, componentWillUpdate).
- 23
警告: Encountered two children 使用相同键
Two or 更多列表项 有相同键 值, 哪个 prevents React 从正确地 identifying 哪个项 更改.
- 24
TypeError: Cannot 读取属性的 空 (读取 'setState')
你 called `这个.setState()` 但 `这个` 是空 or undefined, 通常因为方法 wasn't properly 边界.
- 25
Bug: React Router shows 空白 page for unknown route
用户导航到 URL 那个 doesn't match 任何定义 route, and 否 catch-所有 route exists.
- 26
Bug: useEffect 无限循环 due 到对象 dependency
对象 or 数组 in dependency 数组是 recreated on 每个渲染, causing useEffect 到运行 in 无限循环.
- 27
Issue: React DevTools 不 detecting application
React DevTools 浏览器 extension cannot detect React on page, preventing 组件 inspection.
- 28
Bug: useContext 不更新当 Provider 值更改
上下文 Provider's 值 prop didn't 获取新 引用, 所以 consumers didn't detect 更改 and didn't re-渲染.
- 29
错误: 错误 occurred 虽然加载组件. lazy 组件必须是 默认导出.
模块通过到 React.lazy uses named 导出但 React.lazy expects 默认导出.
- 30
警告: 文本内容做 不 match. 服务器: 'X' 客户端: 'Y'
HTML rendered on 服务器 doesn't match 什么 React 渲染 on 客户端期间 hydration, causing mismatch 警告.
- 31
事件处理器中的 useState 过期闭包
你的事件处理器读取了创建它的渲染中的过期状态值 —— 闭包捕获了旧状态而非当前状态。
- 32
useEffect 无限循环
你的 useEffect 每次运行都更新状态,且依赖数组导致它在每次渲染后运行 —— 造成无限循环。
- 33
Context 值为 undefined 错误
你调用 useContext 但得到 undefined,因为组件在 Provider 树之外或 Context 默认值为 undefined。
- 34
useRef 修改不触发重渲染
你更新了 ref.current 但组件没有重渲染 —— useRef 的修改不被 React 追踪,不触发更新。
- 35
列表渲染缺少 key 属性
你渲染列表时没有 key 属性 —— React 无法追踪哪些项变化,导致添加、删除或重排序时的 bug。
- 36
useMemo 依赖无效导致过期值
你的 useMemo 依赖数组缺少计算使用的值 —— 记忆结果过期,依赖变化时不更新。
- 37
useCallback 依赖过期
你的 useCallback 依赖数组缺少变量 —— 回调捕获过期值并在稍后调用时使用。
- 38
JSX 元素未正确闭合
你的 JSX 有未闭合元素 —— 转译器无法解析 JSX 并在开标签处报告语法错误。
- 39
组件名未大写
你用小写名定义组件 —— React 将 <myComponent> 视为 DOM 元素而非组件,不渲染任何内容。
- 40
无效 Hook 调用:在函数组件外调用
你在函数组件外或条件内调用了 hook —— React 要求 hook 在组件顶层调用。
- 41
组件 Props 类型不匹配
你传递了错误类型的 prop —— 组件期望函数但得到对象,或期望字符串但得到数字。
- 42
Fragment 简写语法错误
你错误使用了 Fragment 简写 <> —— 它不能接受属性且必须用 </> 正确闭合。
- 43
页面组件缺少 export default
你的组件文件缺少 export default —— 框架找不到要为路由渲染的默认组件。
- 44
状态更新批处理导致 UI 过期
你在同一事件处理器中多次调用 setState 并在调用间读取状态 —— React 批处理更新,中间读取是过期的。
- 45
useEffect 缺少清理导致内存泄漏
你的 useEffect 设置了计时器或订阅但无清理返回 —— 组件卸载后资源继续运行。
- 46
派生状态存储在 useState 中
你将从 props 计算的值存储在 useState 中 —— props 变化时它变过期并导致同步 bug。
- 47
条件 Hook 调用违反 hooks 规则
你在 if 语句中调用了 hook —— React 要求每次渲染以相同顺序调用 hook。
- 48
表单输入在受控和非受控间切换
你的 input value 属性首次渲染为 undefined 但之后变为字符串 —— React 警告从非受控切换到受控。
- 49
事件处理器使用闭包中的过期状态
你的 onClick 或 onChange 处理器读取创建处理器时捕获的状态 —— 它看不到最新状态值。
- 50
并发状态更新互相覆盖
你用从当前状态计算的值调用 setState —— 如果重渲染前发生多次更新,只有最后一次生效。
未找到相关错误。