使用 Nitro v3 构建跨运行时 Web 服务器时…

在 Nitro v3 / H3 v2 项目中开发或部署服务端功能时，用本技能定位并执行对应模块的实现方式。

适用场景

解决思路

1. 确认版本与依赖：Nitro v3 使用包名 nitro（原 nitropack），基于 H3 v2、unstorage 和 Vite/Rolldown/Rollup；若不确定 v2/v3 API，先读 references/advanced-migration.md。
2. 使用同一代码库构建并部署到 Node.js、Bun、Deno、Cloudflare、Vercel、Netlify 等目标：通过 portable deployment presets 选择对应 preset；详情读 references/deploy-presets.md。
3. 用文件系统路由组织服务端接口：定义 H3 v2 event handlers，支持动态参数和方法后缀；详情读 references/core-routing.md。
4. 用 route rules 声明式实现缓存、headers、redirects、proxying、auth；详情读 references/core-routing.md。
5. 用缓存层封装 handler/function：defineCachedHandler、defineCachedFunction、SWR，底层基于 unstorage KV；详情读 references/core-cache.md。
6. 用 runtime config，并允许通过 NITRO_* 环境变量覆盖；详情读 references/core-configuration.md。
7. 用 tasks 实现按需和 scheduled/cron 任务，并用 runTask 运行；详情读 references/features-tasks.md。
8. 用 WebSockets/SSE：defineWebSocketHandler、pub/sub、namespaces、event streams；详情读 references/features-websocket.md。
9. 用 SQL database 层：通过 db0、useDatabase、connectors；详情读 references/features-database.md。
10. 用 OpenAPI 自动文档：defineRouteMeta 生成 spec，接入 Scalar/Swagger UI；详情读 references/features-openapi.md。
11. 用 plugins 和 lifecycle hooks：definePlugin、runtime lifecycle hooks、error capture；详情读 references/features-plugins.md。
12. 自定义 renderer 和 server entry，做 HTML/SSR 与框架集成；详情读 references/core-rendering.md。
13. 用 portable deployment presets 做多运行时部署；详情读 references/deploy-presets.md。
14. 用 unstorage KV 做 storage：mount points、drivers、dynamic mounts；详情读 references/core-storage.md。
15. 用 assets：public assets、compression、server assets via storage；详情读 references/core-assets.md。
16. 配置：在 nitro.config.ts 中使用 defineConfig、key options、runtime config；详情读 references/core-configuration.md。
17. 路由：使用 file-based routes、defineHandler、params、middleware、route rules、errors；详情读 references/core-routing.md。
18. v2 → v3 迁移：处理 package rename、nitro/* imports、H3 v2 API、preset changes；详情读 references/advanced-migration.md。

适用边界 · 注意事项

• 需要稳定版 API 或不能接受 beta 行为时，不要直接使用 Nitro v3，先完成 v2→v3 迁移评估。
• 只需要 Nuxt 默认行为、不直接操作 Nitro 层时，不必引入或修改 Nitro 配置与路由。
• 缺少 H3 v2、unstorage、Vite/Rolldown/Rollup 生态前提时，不要假设这些 API 或构建能力可用。