useAsyncData 在 Nuxt 3 中拿不到服务端数据，因其必须在 setup 顶层调用、依赖稳定 key 和 server: true，且不可含浏览器 API 或响应式状态未初始化；$fetch 需在服务端上下文调用并传入必要 headers；defineEventHandler 基于 H3，无中间件链，需手动 throw 错误；构建报错“Cannot find module 'vue'”多因 pnpm workspace 下 vue 未正确链接或缺失显式声明。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
为什么 useAsyncData 在 Nuxt 3 里拿不到服务端数据
因为默认情况下它只在客户端执行，哪怕你写了 server: true，也可能被缓存策略或组件挂载时机绕过。Nuxt 的 SSR 不是“自动全量渲染”，而是按需触发，关键看数据获取的上下文是否在服务端可执行。
-
useAsyncData必须在setup()或<script setup></script>顶层调用，不能包裹在onMounted或事件回调里 - 如果返回值依赖
useState或其他响应式状态，且该状态在服务端未初始化，会导致 hydration mismatch - API 调用若含浏览器专属对象（如
window、document），服务端会直接报错——得用process.client包一层，但注意这会让数据跳过 SSR - 推荐加
lazy: false（默认值）+server: true，并确认key是字符串常量或稳定哈希，避免服务端/客户端 key 不一致导致数据丢失
如何让 $fetch 真正走服务端请求而不是客户端 fallback
$fetch 默认行为是“服务端发请求，客户端复用响应”，但一旦配置出错，就会退化成纯客户端请求，页面首屏看不到数据。
- 确保调用发生在服务端可执行环境：即组件
setup中，且不依赖onMounted、watch或用户交互触发 - 不要在
definePageMeta或middleware里用$fetch——它们不参与数据预取，只做路由控制 - 若后端接口需要 Cookie 或认证头，必须显式传入：
$fetch('/api/user', { headers: { cookie: event.headers.cookie } })，否则服务端拿不到上下文 - 使用
await配合async setup()更稳妥，比单纯 return Promise 更易调试 SSR 流程
Nuxt 3 的 defineEventHandler 和传统 Express 中间件有什么区别
它不是 Express 封装，而是基于 H3（Nuxt 自研 HTTP 工具库）的轻量 handler，没有 next()，也没有中间件链式调用语义。
-
defineEventHandler返回的是一个纯函数，输入H3Event，输出响应，不支持app.use()那种全局注册 - 路径匹配靠文件系统约定（
server/api/user.get.ts→/api/user），不是手动app.get() - 错误处理必须手动
throw createError()，否则会返回 500 且无 body；不能靠 try/catch 吞掉再res.send() - 想复用逻辑？写成普通函数，然后在多个
defineEventHandler里 import 调用，别试图“注入中间件”
部署时 nuxi build 报 Cannot find module 'vue' 怎么办
这不是缺依赖，是构建上下文没识别到 Vue 已安装——常见于 pnpm + workspace 场景，或 node_modules 被清理过但没重装。
- 先运行
pnpm install（不是pnpm i，后者可能跳过 workspace link） - 检查
package.json中是否误删了"vue"（Nuxt 3 不再隐式依赖，必须显式列出） - 若用
pnpm workspace，确认vue在根package.json的devDependencies里，且子项目没覆盖resolutions - CI 环境记得加
--no-frozen-lockfile，否则 pnpm 可能拒绝安装缺失模块
Nuxt 的服务端渲染不是开关一开就全通，每个数据获取点都得确认执行时机、上下文隔离和模块解析路径——漏掉任意一个，就变成“看着像 SSR，实则裸奔 CSR”。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
