关于 Vben5 热更新 Cannot read properties of null (reading 'nextSibling')的分析

问题

保存时仍需报错但是F5正常打包也正常

chunk-ZHNFVA5M.js?v=ac948eb1:11432 Uncaught (in promise) TypeError: Cannot read properties of null (reading 'nextSibling')
    at nextSibling (chunk-ZHNFVA5M.js?v=ac948eb1:11432:35)
    at removeFragment (chunk-ZHNFVA5M.js?v=ac948eb1:6679:14)
    at remove2 (chunk-ZHNFVA5M.js?v=ac948eb1:6650:9)
    at unmount (chunk-ZHNFVA5M.js?v=ac948eb1:6628:9)
    at Object.remove (chunk-ZHNFVA5M.js?v=ac948eb1:9303:13)
    at unmount (chunk-ZHNFVA5M.js?v=ac948eb1:6603:20)
    at unmountComponent (chunk-ZHNFVA5M.js?v=ac948eb1:6713:7)
    at unmount (chunk-ZHNFVA5M.js?v=ac948eb1:6593:7)
    at unmountComponent (chunk-ZHNFVA5M.js?v=ac948eb1:6713:7)
    at unmount (chunk-ZHNFVA5M.js?v=ac948eb1:6593:7)

环境准备

官方原版前端环境(5.5.9版本) 未调整任何配置具体为

transition开
keepAlive关

（后话）跟上面的都没关系

在什么情况才会出现

之前在项目中测试只要是xxx.ts(tsx)保存就会出现该问题 xxx.vue则不会出现

测试非useVbenXXX的页面

先使用playground/src/views/demos/access/index.vue来测试

新建data.ts 然后vue文件引用

data.ts

console.log('code code');

index.vue

import './data';

修改data.ts里的代码（或者直接保存也会触发热更新）页面正常热更新 没有出现问题

测试useVbenModal/Drawer

文件位置playground/src/views/examples/modal/index.vue

还是同样引用data.ts

流程跟上面一样也能正常热更新

测试useVxe

文件位置playground/src/views/examples/vxe-table/basic.vue

data.ts

console.log('code code');

export const column = [
  { title: '序号', type: 'seq', width: 50 },
  { field: 'name', title: 'Name' },
  { field: 'age', sortable: true, title: 'Age' },
  { field: 'nickname', title: 'Nickname' },
  { field: 'role', title: 'Role' },
  { field: 'address', showOverflow: true, title: 'Address' },
];

vue

onMounted(() => {
  console.log('mounted');
});

onBeforeUnmount(() => {
  console.log('unmount');
});

然后保存data.ts 也能正常更新看看Log

卸载再挂载看起来流程没有问题

换个符合业务带查询的表格试试呢 playground/src/views/examples/vxe-table/form.vue

保存也是正常的 (后话: 因为没有Modal/Drawer) 也没有公用data.ts

混合

使用这个页面测试

保存data.ts后一定会复现

先把drawer相关的代码移除发现保存正常了(热更新)

那么确定是useForm的问题?

然后试了单独 drawer+form 的情况(不包含表格) 没问题？

这就奇了怪了 三个单独使用都没问题混在一次就有问题了？

然后回到role菜单来测试保留drawer 但是去除useForm 这样热更新也没问题

只保留一个空drawer 难道是useForm的问题控制变量进一步探究

<script lang="ts" setup>
import type { SystemRoleApi } from '#/api/system/role';

import { computed, ref } from 'vue';

import { useVbenDrawer } from '@vben/common-ui';

import { $t } from '#/locales';

const formData = ref<SystemRoleApi.SystemRole>();

const [Drawer] = useVbenDrawer({});
</script>
<template>
  <Drawer />
</template>

研究过程不赘述 发现将schema改为内部(不引用data.ts) 则不报错

原版 从外部data.ts导入 报错
const [Form, formApi] = useVbenForm({
  schema: useFormSchema(),
  showDefaultActions: false,
});

内部 不报错
const [Form, formApi] = useVbenForm({
  schema: [],
  showDefaultActions: false,
});

最终发现 只要把data.ts中引用的schema移动到新的ts 或者直接在modal.vue 都能正常运行(算一种解决方案)

const [BasicForm, formApi] = useVbenForm({
  commonConfig: {
    labelWidth: 80,
  },
  schema: [直接在这里写 不从data.ts导入],
  showDefaultActions: false,
});

或者

// 跟data.ts文件分开
import { modalSchema } from './other';

const [BasicForm, formApi] = useVbenForm({
  commonConfig: {
    labelWidth: 80,
  },
  schema: modalSchema(),
  showDefaultActions: false,
});

这是一种解决方案但不是最终的解决方案

另外的解决方案

使用热更新api来操作也能正常不推荐

<script setup lang="ts">
const key = ref(0);
if (import.meta.hot) {
  import.meta.hot.accept(() => {
    key.value++;
  });
}
</script>

<template>
  <BasicModal :key="key" :title="title" class="w-[550px]">
    <BasicForm />
  </BasicModal>
</template>

继续分析

问题跟useForm也无关 去除form后保存data.ts 热更新还是报错那么问题就是在modal(drawer)上

那么需要确定是modal造成的还是useVbenModal造成

使用控制变量的方法直接不使用useVbenModal方法导入modal并且更改props来直接显示

packages/@core/ui-kit/popup-ui/src/modal/modal.vue

发现保存热更新也是在报错那么确定就是组件的问题

通过一个个删除元素最终确认！！！

问题出在这个组件 DialogContent!!!

内部是这个组件 radix-vue提供的DialogPortal 确认是这个组件产生的问题

只要这个删除(换成div) 热更新就不会报错（当然样式也会有异常）

到github查看源码

github.com/unovue/reka…

使用的是TeleportPrimitive 问题出在这里查看源码

贴上关键代码

<script setup lang="ts">
import { useMounted } from '@vueuse/core'

withDefaults(defineProps<TeleportProps>(), {
  to: 'body',
})

const isMounted = useMounted()
</script>

<template>
  <Teleport
    v-if="isMounted || forceMount"
    :to="to"
    :disabled="disabled"
    :defer="defer"
  >
    <slot />
  </Teleport>
</template>