Vue3 + Element Plus 报错:Cannot read properties of null (reading 'ce')

问题现象

在组件库中有一个封装组件 ElConfigProvider:

vue 复制代码
<template>
  <el-config-provider v-bind="$attrs">
    <slot></slot>
  </el-config-provider>
</template>

在组件库自己的 demo 项目中使用时一切正常:

vue 复制代码
<ElConfigProvider namespace="otd" :size="'default'">
  <el-button>465</el-button>
</ElConfigProvider>

但当组件库打包后,通过 npm link 链接到另一个业务项目中使用时,控制台出现报错:

js 复制代码
runtime-core.esm-bundler.js:2984 Uncaught (in promise) TypeError: 
Cannot read properties of null (reading 'ce')
    at renderSlot (runtime-core.esm-bundler.js:2984)

初步分析

  • 报错位置在 Vue 3 内部的 renderSlot,意味着插槽 vnode 是 null。

  • 一开始怀疑是 $attrs 透传问题或参数类型不对(如 locale)。

  • 经过多次验证,发现:

    • 在组件库 demo 项目中正常
    • 在业务项目中通过 npm link 使用时报错

这说明问题与业务逻辑本身关系不大,而是运行环境差异造成的。

核心原因

npm link 会在业务项目中产生两个 Vue 实例:

markdown 复制代码
projectA/ (业务项目)
  node_modules/
    vue/   ← 业务项目的 Vue
    otd-ui/  → symlink 到组件库
      node_modules/
        vue/ ← 组件库自己的 Vue

当:

  • 插槽 vnode 是由 业务项目的 Vue 渲染生成的
  • el-config-provider(来自组件库)是由 组件库的 Vue 渲染的

此时 vnode 跨 Vue 实例传递,Vue 内部类型检查不匹配,renderSlot 收到的 vnode.component 是 null,访问 .ce 就会报错。

在组件库 demo 项目中,Vue 实例只有一个,所以不报错

解决方案

目标:保证组件库和业务项目运行时只使用同一个 Vue 实例。

json 复制代码
{
  "peerDependencies": {
    "vue": "^3.2.0",
    "element-plus": "^2.0.0",
    "pinia": "^2.0.0"
  },
  "devDependencies": {
    "vue": "^3.2.0",
    "element-plus": "^2.0.0",
    "pinia": "^2.0.0"
  }
}
bash 复制代码
rm -rf node_modules/vue node_modules/element-plus node_modules/pinia
npm install

方法 2:npm link 时软链业务项目的 Vue

bash 复制代码
cd your-lib
npm link ../your-project/node_modules/vue
npm link ../your-project/node_modules/element-plus

方法 3:用 npm pack 代替 npm link

bash 复制代码
cd your-lib
npm pack
cd ../your-project
npm install ../your-lib/your-lib-0.0.1.tgz

这样依赖结构与正式发布一致,不会重复安装 Vue。

总结

这个错误的根源是 多 Vue 实例导致的 vnode 跨实例传递 。

在 Vue 3 中,不同实例的 vnode 互不兼容,一旦跨实例传递,就可能触发 renderSlot 中的 .ce 空值报错。

避免这个问题的关键是:组件库运行时使用业务项目的 Vue 实例。

相关推荐
January120742 分钟前
【AI方法笔记】2026-11-02:模型流式吐 JSON 时,前端会遇到四种崩法
前端·人工智能·笔记·json
asdzx671 小时前
C# 操作 PDF 元数据:从属性写入到字段提取的完整流程
前端·pdf·c#
吹什么轩1 小时前
constexpr 完全指南:从 const 的两种含义,到编译期计算的四次演进
java·前端·javascript
Bruce_Liuxiaowei2 小时前
前端校验登录态,等于没校验——一次应急广播终端高危漏洞的发现与报送
运维·前端·安全
Meta Luo2 小时前
AI 时代,Web 自动化测试该怎么做?
前端·人工智能·playwright 替代工具·无代码自动化测试工具·低代码 ui 自动化测试·web 回归测试工具
去伪存真2 小时前
AI Agent 性能评估指标与自动化测试落地方案
前端·agent
MaAidan2 小时前
用 Agent 排查线上问题:SLS 日志分析 + DB/Redis 数据验证,一条链路搞清楚
前端·bootstrap·html
墨林陌2 小时前
AI 热点日报(2026-11-03):美团发布 1.6 万亿参数国产大模型,四大厂商共推 AI 训练退出标准
前端
Moment3 小时前
DeepSeek 发布新模型,直接把 Agent 联网搜索的门槛打下来了!
前端·后端
AI宇宙狂想家3 小时前
开源 AI 视频工具进化史:从难用到好用,OpenMontage 改了什么
开发语言·前端·人工智能·开源·ai创业·openmontage