z***@163.com
z***@163.com
  • 发布:2026-03-27 09:46
  • 更新:2026-03-27 09:46
  • 阅读:12

项目启动提示:文件查找失败:'async_hooks'

分类:HBuilderX

之前开发的 uniapp vue2 的项目,运行到浏览器时编译通过后报错,无法启动。
另一个一直维护该项目的同事则没问题,所以尝试了切换到他的版本(HBuilderX 4.76、Node 16)还是同样的错误。
已经尝试分别在HBuilder 4.76和最新的5.x,以及NodeJS 14/16/18均不行,Mac里尝试了也不好使,请问如何处理。
错误信息如下:

09:36:40.708 正在编译中...  
09:36:41.627 ​Browserslist: caniuse-lite is outdated. Please run:  
09:36:41.627   npx update-browserslist-db@latest  
09:36:41.627   Why you should do it regularly: https://github.com/browserslist/update-db#readme​  
09:36:41.637  INFO  Starting development server...  
09:37:11.885 [警告⚠] `node_modules\katex\dist\katex.js` 文件体积超过 500KB,已跳过压缩以及 ES6 转 ES5 的处理,手机端使用过大的js库影响性能。  
09:37:33.291 文件查找失败:'async_hooks' at ..\..\..\Program Files\HBuilderX\HBuilderX.4.76.2025082103\plugins\uniapp-cli\node_modules\bluebird\js\release\promise.js:34
2026-03-27 09:46 负责人:无 分享
已邀请:
Ask小助手

Ask小助手 - Ask社区AI助手

欢迎到专业群( uni-app 官方技术交流群 1 ) 咨询,群中有相关专业的管理员和群友。

抱歉,我在知识库中没有找到关于 "文件查找失败:'async_hooks'" 这个具体错误的解决方案。

从错误信息来看,该错误发生在 HBuilderX 内置的 uniapp-cli 插件目录下的 bluebird 库中,提示找不到 Node.js 的内置模块 async_hooks。由于您已经尝试了以下操作:

  • 切换 HBuilderX 版本(4.76 和 5.x)
  • 切换 Node.js 版本(14/16/18)
  • 更换操作系统(Windows 和 Mac)

建议尝试以下通用排查方法(知识库中类似问题的处理思路):

  1. 清理 HBuilderX 缓存:完全关闭 HBuilderX,删除 HBuilderX 安装目录下的 plugins/uniapp-cli/node_modules 目录,然后重新启动 HBuilderX 让其自动重建

  2. 检查项目 node_modules:删除项目根目录下的 node_modulespackage-lock.json,重新执行 npm install 安装依赖

  3. 对比同事环境:确认同事使用的 HBuilderX 是否是完全相同的安装包(而非自动更新后的版本),以及是否使用了相同的项目代码和依赖版本

  4. 检查项目配置:确认项目根目录的 manifest.jsonvue.config.js 中是否有特殊配置影响了编译器行为

如果问题仍然存在,建议到 ask 社区 发帖并提供完整的复现项目,或提交到 issues 系统 以便官方人员跟进。

内容为 AI 生成,仅供参考

要回复问题请先登录注册