Skip to content
⚛️

React 基础错误

50 个错误

React 常见错误排查手册:Hooks 规则、渲染死循环、Key 警告等问题的成因分析与修复方案。

50 / 50

  1. 1

    ReferenceError: 组件是 不定义

    你 referenced 组件 in JSX 但它 是从不 imported or declared, 所以 JavaScript doesn't know 什么它 是.

  2. 2

    错误: 无效 Hook call

    你 called React Hook (useState, useEffect, etc.) 之外函数组件 or another Hook, 哪个 violates 规则的 Hook.

  3. 3

    错误: React Hook 是 called conditionally

    你 placed Hook call 内部如果语句 or other conditional, 哪个 breaks React's ability 到 track Hook 顺序跨越渲染.

  4. 4

    警告: 每个 child in 列表应该有 唯一键 prop

    你 rendered 列表的 元素不使用 providing 唯一 `键` prop 到每个项, 哪个 prevents React 从 efficiently tracking 项.

  5. 5

    警告: 能't 执行 React 状态更新 on unmounted 组件

    异步操作 (获取, setTimeout, Promise) 已完成之后组件 unmounted and tried 到 call setState, indicating memory leak.

  6. 6

    TypeError: Cannot 读取属性的 undefined (读取 '映射')

    你 called `.映射()` on 变量那个是 `undefined` — 通常因为数据 hasn't 加载 yet or prop wasn't 通过.

  7. 7

    错误: 对象是 不有效 as React child

    你 placed JavaScript 对象 directly in JSX 哪里 React expects 字符串, 数字, or React 元素.

  8. 8

    错误: 最大值更新深度 exceeded

    组件是 stuck in 无限循环的 状态更新 and re-渲染, 通常因为 setState 是 called 期间渲染 or in useEffect 使用错误 dependencies.

  9. 9

    SyntaxError: Adjacent JSX 元素必须是 wrapped in enclosing 标签

    组件 tried 到返回多个 sibling JSX 元素不使用 wrapping 它们 in parent 元素 or 片段.

  10. 10

    警告: React Hook useEffect 有 missing dependency

    你的 useEffect 引用变量那个 isn't in 它的 dependency 数组, 哪个能 cause 副作用到 use stale 值.

  11. 11

    警告: Cannot 更新组件虽然渲染不同组件

    组件 called setState on 不同组件期间渲染 phase, 哪个 React 做不 允许.

  12. 12

    ReferenceError: React 是不 定义

    JSX 需要 React 到是 in 作用域 (in older setups) or automatic JSX 运行时到 是配置. 这个错误平均值 neither 是 satisfied.

  13. 13

    Bug: useState 不更新 UI

    你 mutated 状态 directly 相反的 calling setter 使用新 值, 所以 React didn't detect 更改 and didn't re-渲染.

  14. 14

    错误: 也许多 re-渲染. React 限制数字的 渲染到 prevent 无限循环

    你 called 状态 setter 函数 directly in 组件请求体 (不 in 事件处理函数 or 副作用), causing 无限渲染循环.

  15. 15

    警告: 组件是 更改 controlled 输入到 是 uncontrolled

    输入's `值` prop 更改从 定义值 到 `undefined` (or 空), 切换它 从 controlled 到 uncontrolled.

  16. 16

    Bug: useEffect cleanup 不运行

    cleanup 函数 returned 从 useEffect 是不 运行, 通常因为它 wasn't returned or 副作用有 错误 dependencies.

  17. 17

    警告: 函数组件 cannot 有字符串 refs

    你 used 字符串 ref (e.g., `ref="myRef"`) on 函数组件, 哪个是 legacy API 不 supported in 函数组件.

  18. 18

    警告: React.createElement: 类型是 无效 -- expected 字符串 or 函数/组件但 获取: undefined

    你 rendered `<SomeComponent />` 但 `SomeComponent` 是 undefined, 经常 due 到默认/named 导出 mismatch.

  19. 19

    Bug: Stale 闭包 — 事件处理函数 uses 旧状态值

    事件处理函数创建 in 上一个渲染 captures 状态值 从那个渲染, 不 current one.

  20. 20

    警告: Support for defaultProps 将是 移除从 函数组件

    你设置 `组件.defaultProps` on 函数组件, 哪个是 deprecated. Use JavaScript 默认参数相反.

  21. 21

    警告: ReactDOM.findDOMNode 是 deprecated and 将是 移除

    你 called `ReactDOM.findDOMNode()` 哪个是 deprecated. Use refs attached 到 DOM 元素相反.

  22. 22

    警告: componentWillMount 有是 renamed

    你 used deprecated unsafe lifecycle 方法 (componentWillMount, componentWillReceiveProps, componentWillUpdate).

  23. 23

    警告: Encountered two children 使用相同键

    Two or 更多列表项 有相同键 值, 哪个 prevents React 从正确地 identifying 哪个项 更改.

  24. 24

    TypeError: Cannot 读取属性的 空 (读取 'setState')

    你 called `这个.setState()` 但 `这个` 是空 or undefined, 通常因为方法 wasn't properly 边界.

  25. 25

    Bug: React Router shows 空白 page for unknown route

    用户导航到 URL 那个 doesn't match 任何定义 route, and 否 catch-所有 route exists.

  26. 26

    Bug: useEffect 无限循环 due 到对象 dependency

    对象 or 数组 in dependency 数组是 recreated on 每个渲染, causing useEffect 到运行 in 无限循环.

  27. 27

    Issue: React DevTools 不 detecting application

    React DevTools 浏览器 extension cannot detect React on page, preventing 组件 inspection.

  28. 28

    Bug: useContext 不更新当 Provider 值更改

    上下文 Provider's 值 prop didn't 获取新 引用, 所以 consumers didn't detect 更改 and didn't re-渲染.

  29. 29

    错误: 错误 occurred 虽然加载组件. lazy 组件必须是 默认导出.

    模块通过到 React.lazy uses named 导出但 React.lazy expects 默认导出.

  30. 30

    警告: 文本内容做 不 match. 服务器: 'X' 客户端: 'Y'

    HTML rendered on 服务器 doesn't match 什么 React 渲染 on 客户端期间 hydration, causing mismatch 警告.

  31. 31

    事件处理器中的 useState 过期闭包

    你的事件处理器读取了创建它的渲染中的过期状态值 —— 闭包捕获了旧状态而非当前状态。

  32. 32

    useEffect 无限循环

    你的 useEffect 每次运行都更新状态,且依赖数组导致它在每次渲染后运行 —— 造成无限循环。

  33. 33

    Context 值为 undefined 错误

    你调用 useContext 但得到 undefined,因为组件在 Provider 树之外或 Context 默认值为 undefined。

  34. 34

    useRef 修改不触发重渲染

    你更新了 ref.current 但组件没有重渲染 —— useRef 的修改不被 React 追踪,不触发更新。

  35. 35

    列表渲染缺少 key 属性

    你渲染列表时没有 key 属性 —— React 无法追踪哪些项变化,导致添加、删除或重排序时的 bug。

  36. 36

    useMemo 依赖无效导致过期值

    你的 useMemo 依赖数组缺少计算使用的值 —— 记忆结果过期,依赖变化时不更新。

  37. 37

    useCallback 依赖过期

    你的 useCallback 依赖数组缺少变量 —— 回调捕获过期值并在稍后调用时使用。

  38. 38

    JSX 元素未正确闭合

    你的 JSX 有未闭合元素 —— 转译器无法解析 JSX 并在开标签处报告语法错误。

  39. 39

    组件名未大写

    你用小写名定义组件 —— React 将 <myComponent> 视为 DOM 元素而非组件,不渲染任何内容。

  40. 40

    无效 Hook 调用:在函数组件外调用

    你在函数组件外或条件内调用了 hook —— React 要求 hook 在组件顶层调用。

  41. 41

    组件 Props 类型不匹配

    你传递了错误类型的 prop —— 组件期望函数但得到对象,或期望字符串但得到数字。

  42. 42

    Fragment 简写语法错误

    你错误使用了 Fragment 简写 <> —— 它不能接受属性且必须用 </> 正确闭合。

  43. 43

    页面组件缺少 export default

    你的组件文件缺少 export default —— 框架找不到要为路由渲染的默认组件。

  44. 44

    状态更新批处理导致 UI 过期

    你在同一事件处理器中多次调用 setState 并在调用间读取状态 —— React 批处理更新,中间读取是过期的。

  45. 45

    useEffect 缺少清理导致内存泄漏

    你的 useEffect 设置了计时器或订阅但无清理返回 —— 组件卸载后资源继续运行。

  46. 46

    派生状态存储在 useState 中

    你将从 props 计算的值存储在 useState 中 —— props 变化时它变过期并导致同步 bug。

  47. 47

    条件 Hook 调用违反 hooks 规则

    你在 if 语句中调用了 hook —— React 要求每次渲染以相同顺序调用 hook。

  48. 48

    表单输入在受控和非受控间切换

    你的 input value 属性首次渲染为 undefined 但之后变为字符串 —— React 警告从非受控切换到受控。

  49. 49

    事件处理器使用闭包中的过期状态

    你的 onClick 或 onChange 处理器读取创建处理器时捕获的状态 —— 它看不到最新状态值。

  50. 50

    并发状态更新互相覆盖

    你用从当前状态计算的值调用 setState —— 如果重渲染前发生多次更新,只有最后一次生效。

← 返回错误