使用npm v11.6.2安装包时出现解构'preinstall'属性报错求助

问题详情 #

执行安装命令：

npm install @my-org/test-npm-packages@0.0.1

所有项目和包均触发如下报错：

npm error Cannot destructure property 'preinstall' of 'scripts' as it is null.

注：本地package.json格式有效，未配置preinstall脚本。

环境信息 #

项目本地环境 #

• npm: 11.6.2
• Node.js: 22.18.0
• Angular: 20.3.0

包仓库环境 #

• GitHub Enterprise Server: 3.18.0
• 仓库端npm版本: 10.8.2

此前使用npm 10.9.3时一切正常，临时解决办法是降级npm：

npm install -g npm@10.9.3

社区反馈与解决方案方向 #

不少用户已经在npm官方issue区反馈了npm 11.x版本的类似问题，这属于npm 11版本的兼容性bug——当处理依赖链中某个包的package.json里scripts字段为null（或未定义）时，内部逻辑未做空值校验，导致解构操作崩溃。

除了降级到npm 10.x稳定版外，还可以尝试这些临时方案：

• 检查目标包@my-org/test-npm-packages及其所有依赖的package.json，确认是否存在scripts字段设为null的情况，若有则修改为{}空对象；
• 执行npm cache clean --force清理本地npm缓存后，重新运行安装命令；
• 临时使用npm install --ignore-scripts跳过脚本执行（仅应急用，不推荐长期使用，可能影响包的初始化流程）。

建议关注npm官方后续发布的11.x补丁版本，等待官方修复该bug。

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