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
相关资源
相关术语
相关课程
- Context API
学习 Context。