cloudflare-worker-base

SKILL.md

Production-tested: cloudflare-worker-base-test (https://cloudflare-worker-base-test.webfonts.workers.dev) Last Updated: 2025-10-20 Status: Production Ready ✅

Issue #1: Export Syntax Error Error: "Cannot read properties of undefined (reading 'map')" Source: honojs/hono #3955 Prevention: Use export default app (NOT { fetch: app.fetch })

Issue #2: Static Assets Routing Conflicts Error: API routes return index.html instead of JSON Source: workers-sdk #8879 Prevention: Add "runworkerfirst": ["/api/"] to wrangler.jsonc

使用经过生产测试的模式设置具有 Hono 路由、Vite 插件和静态资产的 Cloudflare Workers。 防止 6 种错误：导出语法、路由冲突、HMR 崩溃和 Service Worker 格式混乱。 使用场合：创建 Workers 项目、为 Workers 配置 Hono 或 Vite、使用 Wrangler 进行部署、 添加带有 SPA 回退的静态资产，或排除导出语法、API 路由冲突、计划的问题 处理程序或 HMR 竞争条件。 关键词：Cloudflare Workers、CF Workers、Hono、wrangler、Vite、静态资产、@cloudflare/vite-plugin、 wrangler.jsonc、ES 模块、run_worker_first、SPA 后备、API 路由、无服务器、边缘计算、 “无法读取未定义的属性”，“静态资产 404”，“挂起的 Promise 被取消”， “处理程序未导出”、部署失败、路由不起作用、HMR 崩溃 来源：ovachiever/droid-tings。

查看原文