Angular 18升级报错：(0 , os_1.availableParallelism) is not a function 求助

错误原因 #

这个报错源于Angular 18依赖的piscina库调用了Node.js的os.availableParallelism()API，而该API仅在Node.js 19.0.0及以上版本支持。如果本地Node.js版本低于19，就会触发这个类型错误。

解决方法 #

方法一：升级Node.js版本 #

1. 查看当前Node.js版本：

   node -v
   

2. 升级到19.x或更高版本：
   • 推荐用nvm（Node版本管理器）安装切换：

     nvm install 19
     nvm use 19
     

   • 也可直接从Node.js官网下载对应版本安装包完成升级。
3. 再次运行node -v确认版本达标，重启项目即可。

方法二：锁定piscina兼容版本（无需升级Node.js） #

如果暂时无法升级Node.js，可通过npm的overrides字段强制使用不依赖os.availableParallelism()的piscina版本：

1. 在项目根目录的package.json中添加配置：

   "overrides": {
     "piscina": "4.0.0"
   }
   

2. 重新安装依赖：

   npm install
   

3. 安装完成后启动项目，报错即可解决。

注意事项 #

• 使用nvm管理Node版本可避免升级影响其他本地项目；
• 若使用overrides后出现其他兼容性问题，可尝试调整piscina的版本号（如3.x系列）。

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