NextJS启动与构建触发Assertion错误求助

报错信息 #

npm[213732]: c:\ws\src\env-inl.h:1041: Assertion `(insertion_info.second) == (true)' failed.
 1: 00007FF7A493052F napi_wrap+109311
 2: 00007FF7A48D5256 v8::internal::OrderedHashTable<v8::internal::OrderedHashSet,1>::NumberOfElementsOffset+33302
 3: 00007FF7A48D55D1 v8::internal::OrderedHashTable<v8::internal::OrderedHashSet,1>::NumberOfElementsOffset+34193
 4: 00007FF7A494E69F node::AddEnvironmentCleanupHook+127
 5: 00007FF7A48FD5A1 napi_add_env_cleanup_hook+49
 6: 00007FFF90FE5057 napi_register_module_v1+8071
 7: 00007FF7A48FD25B node_module_register+7275
 8: 00007FF7A48F9AE0 node::Buffer::New+6352
 9: 00007FF7A48FA873 node::Buffer::New+9827
10: 00007FF7A514E85F v8::internal::Builtins::builtin_handle+321471
11: 00007FF7A514DDF4 v8::internal::Builtins::builtin_handle+318804
12: 00007FF7A514E0E7 v8::internal::Builtins::builtin_handle+319559
13: 00007FF7A514DF33 v8::internal::Builtins::builtin_handle+319123
14: 00007FF7A522A0CD v8::internal::SetupIsolateDelegate::SetupHeap+464173
15: 00007FF7A51C29D2 v8::internal::SetupIsolateDelegate::SetupHeap+40498
16: 00007FF7A51C29D2 v8::internal::SetupIsolateDelegate::SetupHeap+40498
17: 00007FF7A51C29D2 v8::internal::SetupIsolateDelegate::SetupHeap+40498
18: 00007FF7A51C29D2 v8::internal::SetupIsolateDelegate::SetupHeap+40498
19: 00007FF7A51C29D2 v8::internal::SetupIsolateDelegate::SetupHeap+40498
20: 00007FF7A51C29D2 v8::internal::SetupIsolateDelegate::SetupHeap+40498
21: 00007FF7A51C29D2 v8::internal::SetupIsolateDelegate::SetupHeap+40498
22: 00007FF7A526A190 v8::internal::SetupIsolateDelegate::SetupHeap+726512
23: 00007FF7A51BE8DA v8::internal::SetupIsolateDelegate::SetupHeap+23866
24: 00007FF7A52A8473 v8::internal::SetupIsolateDelegate::SetupHeap+981203
25: 00007FF7A51C29D2 v8::internal::SetupIsolateDelegate::SetupHeap+40498
26: 00007FF7A51EF7C0 v8::internal::SetupIsolateDelegate::SetupHeap+224288
27: 00007FF7A526BBBE v8::internal::SetupIsolateDelegate::SetupHeap+733214
28: 00007FF7A51E293D v8::internal::SetupIsolateDelegate::SetupHeap+171421
29: 00007FF7A51C057C v8::internal::SetupIsolateDelegate::SetupHeap+31196
30: 00007FF7A509081F v8::internal::Execution::CallWasm+1839
31: 00007FF7A509092B v8::internal::Execution::CallWasm+2107
32: 00007FF7A509136A v8::internal::Execution::TryCall+378
33: 00007FF7A5071B85 v8::internal::MicrotaskQueue::RunMicrotasks+501
34: 00007FF7A50718E0 v8::internal::MicrotaskQueue::PerformCheckpoint+32
35: 00007FF7A49541C0 node::CallbackScope::~CallbackScope+672
36: 00007FF7A49545BB node::CallbackScope::~CallbackScope+1691
37: 00007FF7A4954A01 node::MakeCallback+209
38: 00007FF7A491F04E napi_wrap+38430
39: 00007FF7A49796C8 uv_check_init+120
40: 00007FF7A49842E8 uv_run+664
41: 00007FF7A4890255 v8::internal::OrderedHashTable<v8::internal::OrderedHashSet,1>::NumberOfBucketsOffset+9365
42: 00007FF7A49039B7 node::Start+311
43: 00007FF7A476686C RC4_options+339820
44: 00007FF7A570619C v8::internal::compiler::RepresentationChanger::Uint32OverflowOperatorFor+153532
45: 00007FF8741626BD BaseThreadInitThunk+29
46: 00007FF8759EDFB8 RtlUserThreadStart+40
npm ERR! code ELIFECYCLE
npm ERR! errno 1
npm ERR! my-app@0.1.0 dev: `next dev -p 5000`
npm ERR! Exit status 1

问题背景 #

切换回main分支并清除本地修改（仅新增过几个内容页面和API调用表单）后，应用仍无法启动/构建，Win11系统，Node服务本身运行正常。

解决方案 #

1. 清除依赖缓存与重装 #

• 删除项目根目录下的node_modules文件夹
• 删除package-lock.json或yarn.lock文件
• 执行缓存清理命令：

  npm cache clean --force
  # 使用yarn则执行：yarn cache clean
  

• 重新安装依赖：

  npm install
  # 使用yarn则执行：yarn install
  

2. 调整Node版本 #

该报错多与Node版本和项目依赖兼容性有关：

• 查看package.json中engines字段指定的Node版本，切换到对应版本
• 使用nvm切换到LTS稳定版（如18.x或20.x）：

  nvm install 20
  nvm use 20
  

3. 清理NextJS缓存 #

执行NextJS官方缓存清理命令：

npx next clean

4. 排查第三方依赖冲突 #

• 暂时移除新增代码中的第三方库调用，测试是否能正常启动
• 用npm ls或yarn list查看依赖树，定位版本冲突的包

5. 修复Windows权限问题 #

• 以管理员身份打开终端，重新执行启动/构建命令
• 检查项目目录权限，确保当前用户拥有读写权限

6. 重置Node环境 #

若以上方法无效：

• 完全卸载当前Node版本，清理残留文件（如C:\Program Files\nodejs目录、用户目录下的.npmrc及缓存）
• 重新下载安装官方稳定版Node

内容的提问来源于stack exchange，提问作者fedjedmedjed