Question

在线上版本的 Rax 打包策略中，我们移除了冗长的错误提示以获得更小的包 (bundle) 体积，而使用一个数字类型的错误码来替代。本文可以帮助你找到错误码对应的错误原因，以便完成线上问题的排查。

需要注意的是，错误码仅是帮助快速完成异常定位，如果需要获取发生错误的调用栈，你仍需要将 Rax 打包为开发版本并通过 sourceMap 机制找到异常在源码中的位置。

注：线上版本指的是使用 rax-scripts 执行 build 操作时打出的代码包，会注入 process.env.NODE_ENV 变量的值为 production，你也可以直接使用预构建的分发版本 rax/dist/rax.min.js 文件。

错误码 0

Type of createElement should not be null or undefined.

这个错误出现在调用 createElement 方法时。当传入的第一个参数为 null 或者 undefined 时会触发这个问题，通常可能是因为未获取到创建的 JSX 组件的引用：

以下例子中，如果引入的 Foo 为 null 或 undefined，便会触发该错误。

import Foo from './some-where';

<Foo /> 
// compiled to `createElement(Foo)`

错误码 1

Hooks can only be called inside a component.

这个错误出现在调用 Rax hooks 相关 API 时。通常有两种可能，一是在业务中引入了多份 Rax，而调用 hooks 的 Rax 并没有实际参与渲染；二是在组件渲染流程外调用了 hooks，或者是在 class 组件中调用了 hooks API。

错误码 2

Invalid element type.

这个错误通常出现在渲染异常类型的节点时，Rax 接受的节点类型包括 Element(createElement 返回的对象)，Array，String，Number，Boolean，null，undefined。

错误码 3

ref: multiple version of Rax used in project.

这个错误通常出现在使用 ref 时，引入了多份 Rax 实例。

错误码 4

Too many re-renders, the number of renders is limited to prevent an infinite loop.

这个错误通常出现在死循环调用的组件中，当短时间内渲染的次数超过阈值时，Rax 认为渲染流程陷入了无限循环。

错误码 5

Driver not found.

这个错误通常出现在调用 render 方法未传入 driver 时，从 Rax 1.0 开始，render 方法必须显式指定渲染的 driver。

import { render, createElement } from 'rax';
import DriverUniversal from 'universal-driver';

render(<div />, null, { driver: DriverUniversal });