安装ng-toolkit/universal时运行npm run server提示Missing script错误如何解决

架构老林

2026-9-26

你可以按以下步骤排查确认对应的执行逻辑：

先执行npm run命令，查看当前package.json里所有已注册的可用脚本
不同版本的ng-toolkit/universal对服务启动命令的命名规则有差异，早期版本用server，后续版本可能将其更名为serve:ssr、dev:ssr或者start:server，优先找名称里带ssr、universal、server字段的脚本，优先尝试执行这些脚本验证是否符合预期。
若没有找到匹配的脚本，可手动补充对应的server脚本条目
先确认你的项目中是否存在服务端启动入口文件，默认初始化完成的ng-toolkit项目，服务端入口一般为dist/[你的项目名称]/server/main.js，你可以在package.json的scripts字段中新增如下条目：
```
"server": "node dist/你的项目名/server/main.js"
```
如果需要开发模式下热更新启动SSR服务，可添加如下条目：
```
"server": "ng run 你的项目名:serve-ssr"
```
注意执行npm run server前，需要先执行对应SSR构建命令（一般为build:ssr）生成dist目录下的服务端资源。
排查初始化流程是否完整
如果你执行ng add相关初始化命令的过程中出现过依赖冲突、权限报错等问题，会导致工具没有自动把对应的scripts注入到package.json中，你可以清空node_modules和lock文件后重新执行初始化命令，确认所有步骤执行无报错后再查看scripts字段。