Nuxt3正式发布后项目构建失败问题求助

错误详情 #

[nuxt] [request error] globalThis.__publicAssetsURL is not a function

7: 00007FF73CAA6344 v8::internal::Heap::CollectGarbage+4244
 8: 00007FF73CAA3CC0 v8::internal::Heap::AllocateExternalBackingStore+2000
 9: 00007FF73CAC19D0 v8::internal::FreeListManyCached::Reset+1408
10: 00007FF73CAC2085 v8::internal::Factory::AllocateRaw+37
11: 00007FF73CAD775B v8::internal::FactoryBase<v8::internal::Factory>::NewRawOneByteString+75
12: 00007FF73C8BAFDB v8::internal::String::SlowFlatten+395
13: 00007FF73C62523B v8::internal::WasmTableObject::Fill+603
14: 00007FF73C80D179 v8::internal::RegExp::ExperimentalOneshotExec+1161
15: 00007FF73C80CC37 v8::internal::RegExp::Exec+199
16: 00007FF73C7E8AEC v8::internal::DeclarationScope::was_lazily_parsed+21452
17: 00007FF73CCA9571 v8::internal::SetupIsolateDelegate::SetupHeap+494417
18: 00007FF73CD00963 v8::internal::SetupIsolateDelegate::SetupHeap+851779
19: 00007FF73CC9D0F4 v8::internal::SetupIsolateDelegate::SetupHeap+444116
20: 0000015876047A0B

已尝试的排查操作 #

• 完全重新安装项目
• 替换package.json、lock.json并重新安装node_modules
• 在不同电脑及操作系统环境中运行项目

补充说明 #

问题明确始于Nuxt3正式发布之后，附错误截图。

解决方案 #

这个错误多由Nuxt3版本兼容性或构建配置冲突导致，可按以下步骤修复：

1. 锁定兼容的Nuxt3版本
   查看项目历史依赖记录，将nuxt版本锁定到Nuxt3正式发布前的稳定版（如3.0.0-rc.13），或升级至最新正式版补丁版本。修改package.json后执行：

   npm install
   

2. 检查资源配置与第三方依赖
   打开nuxt.config.ts，确认是否自定义了publicAssets相关规则，或使用了依赖__publicAssetsURL的第三方插件。尝试注释相关配置后重新构建，排查是否为配置冲突。

3. 清理Nuxt构建缓存
   执行命令清理旧缓存文件，避免干扰新构建：

   npx nuxi clean
   

4. 验证Node.js版本
   Nuxt3要求使用官方推荐的Node.js版本（如18.x或20.x LTS），过低或过高版本可能引发运行时API不兼容问题。

5. 排查第三方模块冲突
   逐个禁用项目中的第三方模块/插件，重新构建测试，定位是否为某一依赖与Nuxt3正式版不兼容导致错误。

内容的提问来源于stack exchange，提问作者Алексей Огневой