React报错之Objects are not valid as a React child
总览
当我们尝试在JSX代码中，直接渲染对象或者数组时，会产生 "Objects are not valid as a react child" 错误。为了解决该错误，在JSX代码中，使用 map() 方法来渲染数组或者访问对象的属性。
下面是错误如何发生的示例。
export default function App() {
const employees = [
{id: 1, name: 'Alice', country: 'Austria'},
{id: 2, name: 'Bob', country: 'Belgium'},
{id: 3, name: 'Carl', country: 'Canada'},
];
const obj = {
id: 4,
name: 'Dean',
country: 'Denmark',
};
// :no_entry:️ Uncaught Error: Objects are not valid as a React child (found: object with keys {id, name, country}).
// If you meant to render a collection of children, use an array instead.
return (
<div>
{employees}
{obj}
</div>
);
}map
上述代码片段的问题在于，在JSX代码中我们尝试直接渲染数组或者对象。
为了解决该错误，当渲染JSX代码时，使用 map() 方法来渲染数组或者访问对象的属性。
export default function App() {
const employees = [
{id: 1, name: 'Alice', country: 'Austria'},
{id: 2, name: 'Bob', country: 'Belgium'},
{id: 3, name: 'Carl', country: 'Canada'},
];
const obj = {
id: 4,
name: 'Dean',
country: 'Denmark',
};
return (
<div>
{employees.map((employee, index) => {
return (
<div key={index}>
<h2>name: {employee.name}</h2>
<h2>country: {employee.country}</h2>
<hr />
</div>
);
})}
<hr />
<hr />
<hr />
<div>
<h2>name: {obj.name}</h2>
<h2>county: {obj.country}</h2>
</div>
<hr />
</div>
);
}当调试时，可以使用 console.log 来打印导致错误的值。
JSON.stringify
或者，你可以在JSX代码中使用 JSON.stringify() 转换该值，以确保它是预期的类型。
export default function App() {
const employees = [
{id: 1, name: 'Alice', country: 'Austria'},
{id: 2, name: 'Bob', country: 'Belgium'},
{id: 3, name: 'Carl', country: 'Canada'},
];
const obj = {
id: 4,
name: 'Dean',
country: 'Denmark',
};
return (
<div>
<h4>{JSON.stringify(employees)}</h4>
<h4>{JSON.stringify(obj)}</h4>
</div>
);
}JSON.stringify() 方法将会在对象渲染之前，将其转换为字符串。
你必须确保在JSX代码中，不会渲染对象或者数组。相反，你必须渲染原始值，比如说字符串以及数值。
Date
另一个导致该错误的常见原因是，在JSX代码中我们试图直接渲染 Date 对象时。
export default function App() {
const date = new Date();
// :no_entry:️ Objects are not valid as a React child (found: [object Date]).
return (
<div>
<h4>{date}</h4>
</div>
);
}为了解决该问题，我们必须访问 Date 对象上的方法，比如说， toLocaleDateString() 。
export default function App() {
return (
<div>
<h4>{date.toLocaleDateString()}</h4>
</div>
);
}现在，我们使用字符串代替对象来进行渲染，因此该错误被解决。
花括号
如果错误依旧存在，请确保当渲染变量时，你没有使用双花括号。
export default function App() {
const message = 'hello world';
// :no_entry: Objects are not valid as a React child (found: object with keys {message}).
return (
<div>
<h4>{{message}}</h4>
</div>
);
}注意 message 变量包裹在两组花括号内，这也是为什么React认为尝试渲染一个对象。为了解决该问题，可以只将变量包裹在一组大括号中。
export default function App() {
return (
<div>
<h4>{message}</h4>
</div>
);
}现在React把 message 变量当作一个包含字符串的表达式，而不是一个对象。
async
如果错误依旧存在，请确保在JSX代码中没有调用 async 函数。
async 函数返回一个 Promise 对象，因此在JSX代码中，如果调用了 async 函数，则错误就会发生。
export default function App() {
async function getData() {
return Promise.resolve(42);
}
// :no_entry: Objects are not valid as a React child (found: [object Promise]).
return (
<div>
<h4>{getData()}</h4>
</div>
);
}为了解决该错误，我们必须在 useEffect 钩子或者事件处理器里调用 async 函数，比如说， onClick 。
import {useEffect, useState} from 'react';
export default function App() {
const [num, setNum] = useState(0);
useEffect(() => {
async function getData() {
const result = await Promise.resolve(42);
setNum(result);
}
getData();
}, []);
return (
<div>
<h4>{num}</h4>
</div>
);
}在 useEffect 钩子中调用 async 函数可以解决这个错误，因为我们现在渲染的是一个数字，而不是 Promise 对象。
总结
发生 "Objects are not valid as a React child" 的React错误有多种原因：
- 在JSX代码中直接渲染对象或者数组；
- 在JSX代码中直接渲染 Date 对象；
- 在两组花括号中包裹变量，比如： {{message}} 而不是 {message} ；
- 在JSX代码中调用 async 函数。
来源：https://bobbyhadz.com/blog/react-objects-are-not-valid-as-react-child
本文内容仅供个人学习、研究或参考使用，不构成任何形式的决策建议、专业指导或法律依据。未经授权，禁止任何单位或个人以商业售卖、虚假宣传、侵权传播等非学习研究目的使用本文内容。如需分享或转载，请保留原文来源信息，不得篡改、删减内容或侵犯相关权益。感谢您的理解与支持！
