cloudflare-worker-base

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

Настройте Cloudflare Worker с помощью маршрутизации Hono, плагина Vite и статических активов, используя проверенные на производстве шаблоны. Предотвращает 6 ошибок: синтаксис экспорта, конфликты маршрутизации, сбои HMR и путаница формата Service Worker. Используйте при: создании проектов Workers, настройке Hono или Vite для Workers, развертывании с помощью Wrangler, добавление статических ресурсов с резервным SPA или устранение неполадок синтаксиса экспорта, конфликтов маршрутов API, запланированных обработчики или условия гонки HMR. Ключевые слова: работники Cloudflare, работники CF, Hono, wrangler, Vite, статические активы, @cloudflare/vite-plugin, wrangler.jsonc, модуль ES, run_worker_first, резервный вариант SPA, маршруты API, бессерверные вычисления, периферийные вычисления, «Невозможно прочитать свойства неопределенного объекта», «Статические активы 404», «Висячее обещание было отменено», «Обработчик не экспортирует», развертывание завершается сбоем, маршрутизация не работает, HMR аварийно завершает работу. Источник: ovachiever/droid-tings.