解决 L7 项目升级 dumi 2.3 后案例页面白屏问题

问题背景

在 antvis/L7 项目中，当将文档工具 dumi 从 2.2.x 版本升级到 2.3.x 版本后，部分案例页面出现了白屏现象。具体表现为访问类似案例示例页面时，浏览器控制台报错，页面无法正常渲染。

问题现象

升级后访问案例页面时，页面呈现空白状态，浏览器控制台显示 JavaScript 错误。这种情况主要发生在包含特定路由参数的页面，如带有哈希标识的案例页面。

技术分析

dumi 2.3 版本在路由处理、代码分割或动态加载机制上可能进行了调整，导致与 L7 项目中现有的案例页面结构或配置存在兼容性问题。特别是对于带有哈希路由的页面，新版本可能采用了不同的处理方式。

解决方案

目前推荐的临时解决方案是将 dumi 版本锁定在 2.2.17 版本。这个版本经过验证能够稳定支持 L7 项目的文档展示需求，特别是对于案例页面的渲染。

对于长期解决方案，建议：

1. 等待 dumi 官方修复相关兼容性问题
2. 或者对项目配置进行调整，适配 dumi 2.3 的新特性
3. 检查案例页面的路由配置和组件加载方式

实施建议

对于正在使用 L7 进行开发的团队，如果遇到类似问题，可以按照以下步骤操作：

1. 在 package.json 中明确指定 dumi 版本为 2.2.17
2. 删除 node_modules 和 lock 文件
3. 重新安装依赖
4. 重启开发服务器

这样可以确保文档系统稳定运行，不影响项目的开发和文档展示。