Nuxt.js SSR模式build后部分页面缺失问题排查求助

排查方向与修复方案 #

1. 构建缓存冲突修复 #

Nuxt2默认会复用.nuxt目录下的历史编译缓存，多实例原有目录的缓存差异会导致webpack增量编译异常，出现服务端路由漏打包的情况。
修复操作：在yarn build执行前新增缓存清理步骤，执行命令：
rm -rf .nuxt dist node_modules/.cache
确保每次构建为全量编译，排除历史缓存干扰。

2. 依赖安装一致性修复 #

Yarn v1版本存在依赖提升逻辑偶发不一致的问题，即使yarn.lock完全相同，网络波动、镜像源响应差异也可能导致依赖结构异常，触发构建差异。
修复操作：

• 将yarn install替换为yarn install --frozen-lockfile，强制完全按照锁文件版本安装依赖，禁止自动版本升级
• 有条件可改用统一构建机预打包，直接将构建产物同步到所有实例启动，完全避免多实例分别构建的差异

3. 残留进程占用修复 #

部署步骤中停止服务后，若有残留Node进程占用.nuxt目录的文件，会导致构建时部分页面资源写入失败，最终产物缺失。
修复操作：停止服务后新增进程清理命令：
pkill -f "yarn start|node"
确认所有相关进程完全退出后再执行后续构建步骤。

4. Nuxt版本已知bug修复 #

当前使用的Nuxt v2.15.4存在已知的自动路由扫描偶发遗漏bug，当pages目录嵌套层级深、文件数量多时，路由生成逻辑可能漏扫页面。
修复操作：

• 升级到Nuxt v2.17.3（2.x最新稳定版，无兼容性问题）
• 或者在nuxt.config.js中通过router.extendRoutes手动配置全量路由，避免自动扫描的偶发故障

验证方式 #

先在单个曾出现构建异常的实例上使用修改后的部署流程重复构建10次以上，确认无页面缺失问题后再全量更新所有实例的部署流程。

内容的提问来源于stack exchange，提问作者Jens Römer