用途:帮助开发者在 Cloudflare Workers 上使用现代框架构建全栈应用,涵盖路由、SSR、静态资源与运行时绑定等集成问题。
主要能力:提供框架选型决策树(仅需 API 选 Hono;React 选 Next.js/OpenNext 或 Remix;Vue 选 Nuxt;Svelte 选 SvelteKit;内容型选 Astro;追求性能选 Qwik),并给出各框架的 SSR、静态资源与 Workers 原生支持对照。汇总十大常见错误及原因与解决方向,如导出格式错误、CPU 超限、缺少 context、Node.js 全局变量、CJS 与 ESM 混用、响应体已读取、绑定未配置、静态资源 404、水合不一致、循环导入。
使用方式:按需加载对应框架参考文档(hono.md、remix.md、nextjs.md、astro.md、sveltekit.md、qwik.md、nuxt.md)。Hono 示例中通过 new Hono<{ Bindings: Env }>() 定义环境绑定,使用 logger()、cors() 中间件,c.env.DB.prepare 访问 D1,export default app 导出;wrangler.jsonc 中配置 main、compatibility_date、compatibility_flags(如 nodejs_compat)与 d1_databases 绑定。静态资源通过 assets.directory 与 assets.binding 配置,并用 c.env.ASSETS.fetch(c.req.raw) 回退。各框架访问绑定的方式不同:Remix 用 context.cloudflare.env,Astro 用 Astro.locals.runtime.env,SvelteKit 用 platform.env,Nuxt 用 useRuntimeConfig 或 event.context.cloudflare.env。
适用场景:在 Workers 上构建 API、微服务、全栈 React/Vue/Svelte 应用、内容站点与高性能可恢复应用。
限制:资料未提供具体版本要求、收费信息与完整部署步骤;Next.js 需借助 OpenNext,部分框架需适配器;性能建议包括压缩包体小于 1MB、减少顶层代码、使用流式 SSR、Cache API 与动态导入。