迹忆客 专注技术分享

出现“Component cannot be used as a JSX component”的错误有多种原因：

1. 返回 JSX 元素数组而不是单个元素。
2. 从组件返回 JSX 元素或 null 以外的任何值。
3. 具有过时版本的 React 类型。

下面是一个产生上述错误的示例

// ⛔️ 'App' cannot be used as a JSX component.
// Its return type 'Element[]' is not a valid JSX element.
// Type 'Element[]' is missing the following properties from type 'ReactElement<any, any>': type, props, key
const App = () => {
  return ['a', 'b', 'c'].map(element => {
    return <h2 key={element}>{element}</h2>;
  });
};

export default App;

问题在于我们返回的是一个 JSX 元素数组，而不是单个 JSX 元素。

为了解决这个错误，我们必须使用 React 片段或 div 元素来包装数组。

const App = () => {
  return (
    <>
      {['a', 'b', 'c'].map(element => {
        return <h2 key={element}>{element}</h2>;
      })}
    </>
  );
};

export default App;

现在我们的组件返回单个 JSX 元素，因此错误已解决。

当我们需要在不向 DOM 添加额外节点的情况下对子列表进行分组时，会使用片段。

我们可能还会看到使用了更冗长的片段语法。

import React from 'react';

const App = () => {
  return (
    <React.Fragment>
      {['a', 'b', 'c'].map(element => {
        return <h2 key={element}>{element}</h2>;
      })}
    </React.Fragment>
  );
};

export default App;

我们还可以使用包装器 div 元素从您的组件返回单个 JSX 元素。

“Component cannot be used as a JSX component”错误的另一个常见原因是当我们从组件返回 JSX 元素或 null 以外的任何内容，或者忘记返回值时。

// ⛔️ 'App' cannot be used as a JSX component.
// Its return type 'undefined' is not a valid JSX element.
const App = () => {
  // 👇️ this returns undefined
  return
  <h2>hello world</h2>
};

export default App;

App 组件返回 undefined 是因为我们将 return 语句放在一行，将 JSX 代码放在下一行，而没有使用括号。

我们不允许从组件返回 undefined，所以错误发生了。

要解决该错误，请确保我们返回的代码可访问。

const App = () => {
  return (
    <div>
      <h2>hello world</h2>
    </div>
  );
};

export default App;

如果我们确定从 React 组件返回单个 JSX 元素或 null 但错误仍然存在，请尝试更新我们的 React 类型。

在项目的根目录（package.json 文件所在的位置）中打开终端并运行以下命令：

# 👇️ 使用 NPM
$ npm install --save-dev @types/react@latest @types/react-dom@latest

# 👇️ 如果你还想更新 react 和 react-dom
$ npm install react@latest react-dom@latest

# ------------------------------

# 👇️ 使用 YARN
$ yarn add @types/react@latest @types/react-dom@latest --dev

# 👇️ 如果你还想更新 react 和 react-dom
$ yarn add react@latest react-dom@latest

该命令将更新我们的 React 类型的版本。

如有必要，请确保重新启动开发服务器和 IDE。 在我们停止并重新运行 npm start 命令之前，开发服务器不会获取更改。

如果错误未解决，请尝试删除 node_modules 和 package-lock.json（不是 package.json）文件，重新运行 npm install 并重新启动 IDE。

# 👇️ delete node_modules and package-lock.json
$ rm -rf node_modules
$ rm -f package-lock.json
$ rm -f yarn.lock

# 👇️ clean npm cache
$ npm cache clean --force

$ npm install

如果错误仍然存在，请确保重新启动 IDE 和开发服务器。 VSCode 经常出现故障，有时重启可以解决问题。