我所理解的 Nuxt 最佳实践(3):用插件依赖声明启动顺序
- 沿着路由组织页面和自动导入
- 按请求隔离状态,让客户端接得住首屏
- 用插件依赖声明启动顺序(当前)
- 部署前检查资源与服务端产物
一个通知插件需要在 WebSocket 建连前注册监听。给它加上 enforce: 'pre',监听确实开始得更早,却也赶在 Pinia 安装之前调用了 useAppStore(),应用在启动阶段报错。通知插件要等 Pinia 就绪,WebSocket 又要等通知监听注册完成。两个等待条件分别写在通知插件和 WebSocket 插件里。
把等待关系写进各自的插件
先给通知插件一个可引用的名字。它声明等待 pinia,WebSocket 插件声明等待 ws-system-notify。以下只保留通知插件的依赖和初始化入口,registerNotificationListener 代表项目自己的监听注册函数。
export default defineNuxtPlugin({
name: 'ws-system-notify',
dependsOn: ['pinia'],
async setup() {
const app = useAppStore();
await registerNotificationListener(app);
},
});
enforce 调整插件所处的执行阶段,dependsOn 让当前插件等待指定插件完成。两者表达的约束不同。文件名顺序可以帮助安排默认执行顺序,有明确依赖时就把依赖写出来。依赖名称也要在当前运行端能找到,例如客户端插件依赖的前置插件必须在客户端插件集合中。见 Nuxt 插件目录与执行顺序。
setup 返回时,前置工作要真的就绪
如果监听是异步注册的,通知插件要等注册完成再结束 setup。只发起异步任务就返回,后续插件仍可能先建立连接,把首批消息交给尚未装好的监听器。排查时除了核对生成结果中的插件名,也要观察 Pinia 就绪、监听完成和 WebSocket 建连这三个时点。
对这个项目,可以用静态检查提前发现 enforce: 'pre' 与直接调用 Pinia API 同时出现。间接调用、异步完成时点和真实消息交付由启动与交互验证覆盖。原案例保留了错误堆栈、依赖链和历史例外的处理。见《Nuxt plugin 抢跑 Pinia 为什么会把应用启动打挂》。