解决Unibest项目中运行pnpm dev时崩溃的问题

解决Unibest项目中运行pnpm dev时崩溃的问题

unibest unibest - 最好用的 uniapp 开发框架。unibest 是由 uniapp + Vue3 + Ts + Vite4 + UnoCss + UniUI 驱动的跨端快速启动模板，使用 VS Code 开发，具有代码提示、自动格式化、统一配置、代码片段等功能，同时内置了大量平时开发常用的基本组件，开箱即用，让你编写 uniapp 拥有 best 体验。 项目地址: https://gitcode.com/gh_mirrors/un/unibest

问题现象

在使用Unibest项目进行开发时，开发者可能会遇到一个棘手的问题：当运行pnpm dev:mp-weixin命令启动项目后，如果修改项目文件并保存，有一定概率会导致项目突然停止运行，控制台会抛出以下错误信息：

node:events:497
      throw er; // Unhandled 'error' event
      ^

Error: EBUSY: resource busy or locked, lstat 'D:\DumpStack.log.tmp'

错误分析

这个错误的核心是EBUSY: resource busy or locked，表明系统试图访问一个被锁定的文件。具体来说：

1. 错误发生在文件监视(FSWatcher)过程中
2. 系统尝试读取D:\DumpStack.log.tmp文件时发现该文件被锁定
3. 这个错误未被正确处理，导致进程崩溃

解决方案

经过技术社区的研究，这个问题主要与Vite的文件监视机制有关。以下是几种可行的解决方案：

方案一：修改Vite配置

在vite.config.js中添加以下配置：

server: {
  watch: {
    usePolling: true,
    interval: 1000
  }
}

这种方法通过轮询方式替代默认的文件系统事件监听，可以避免文件锁定问题。但根据反馈，此方法可能在某些环境下仍然无效。

方案二：升级Vite版本

将Vite升级到4.5.3或更高版本。新版本中对文件监视机制进行了优化，虽然可能仍会显示一些提示信息，但能有效防止进程崩溃。

方案三：排除特定文件

在vite.config.js中配置排除特定文件的监视：

server: {
  watch: {
    ignored: ['D:\\DumpStack.log.tmp']
  }
}

这种方法直接忽略导致问题的文件，简单有效。

最佳实践建议

1. 对于Unibest项目，推荐使用方案二（升级Vite版本）作为长期解决方案
2. 如果升级后仍有问题，可以结合方案一和方案三
3. 开发过程中注意观察控制台输出，及时识别类似问题
4. 定期更新项目依赖，获取最新的稳定性修复

技术背景

这个问题本质上是由于Windows系统下文件锁定机制与Node.js文件监视模块的交互问题导致的。当系统生成DumpStack.log.tmp文件时，会短暂锁定该文件，而Vite/Rollup的文件监视器未能正确处理这种锁定状态，导致未捕获的异常。

理解这一机制有助于开发者在遇到类似问题时能够快速定位和解决，而不是仅仅停留在表面现象的处理上。

unibest unibest - 最好用的 uniapp 开发框架。unibest 是由 uniapp + Vue3 + Ts + Vite4 + UnoCss + UniUI 驱动的跨端快速启动模板，使用 VS Code 开发，具有代码提示、自动格式化、统一配置、代码片段等功能，同时内置了大量平时开发常用的基本组件，开箱即用，让你编写 uniapp 拥有 best 体验。 项目地址: https://gitcode.com/gh_mirrors/un/unibest