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를 설정하세요. 내보내기 구문, 라우팅 충돌, HMR 충돌, 서비스 워커 형식 ​​혼동 등 6가지 오류를 방지합니다. 사용 시기: 작업자 프로젝트 생성, 작업자용 Hono 또는 Vite 구성, 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.

원본 보기