Skip to content

Context 值为 undefined 错误

快速摘要

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

为什么发生

  • 使用 useContext 的组件渲染在提供值的 Context.Provider 之外

  • Context 创建时默认值为 undefined 且没有 Provider 包裹消费组件

  • Provider 的 value 属性因条件或加载状态未解析而为 undefined

最小示例

✗ 错误代码
const ThemeContext = createContext(undefined);
function Button() {
  const theme = useContext(ThemeContext);
  return <button className={theme.color}>Click</button>; // theme is undefined!
}
✓ 修复代码
const ThemeContext = createContext({ color: 'blue' });
function Button() {
  const theme = useContext(ThemeContext);
  return <button className={theme.color}>Click</button>; // safe default
}
// Or wrap with provider: <ThemeContext.Provider value={{color:'red'}}>

创建 Context 时提供默认值确保 useContext 始终返回可用对象,即使没有 Provider。

如何诊断

  • 记录 context 值确认它是 undefined:const ctx = useContext(MyContext); console.log(ctx)

  • 检查组件树验证 Provider 包裹了调用 useContext 的组件

  • 检查 Provider 的 value 属性确保消费时不是 undefined 或 null

如何修复

  • 用 Context.Provider 包裹消费组件并传入有效的 value 属性

  • 创建 Context 时提供有意义的默认值而非 undefined,使其无 Provider 也能工作

  • 在 useContext 后添加 null 检查,值为 undefined 时抛出带帮助信息的自定义错误

如何预防

  • 创建 Context 时始终提供默认值,或在 Provider 缺失时抛出描述性错误

  • 用包装 useContext 的自定义钩子,值为 undefined 时抛出错误,强制使用 Provider

相关资源

相关术语

相关课程

← 返回语言