Cloudflare Workers Cron Trigger 작동 안 할 때 체크리스트 (2026)

Cron Trigger 설정

Cron Trigger가 예상대로 실행되지 않을 때, 순서대로 점검하면 대부분 원인을 찾을 수 있다. 이 글은 내가 실제로 Cloudflare Workers의 Cron Trigger를 운영하면서 겪었던 문제들을 체크리스트 형태로 정리한 것이다. wrangler.toml 설정 실수부터 UTC 타임존 혼동, scheduled() 핸들러 누락까지 — 한 항목씩 따라가다 보면 어디서 막혔는지 금방 파악할 수 있을 거다. 📑 목차 증상부터 확인하기 wrangler.toml [triggers] … 더 읽기

Cloudflare Workers 환경변수 Secrets 설정 및 접근 안 될 때 해결법

Workers Secrets 설정

Workers에서 환경변수를 다룰 때, 로컬과 프로덕션의 차이를 간과하는 경우가 많다. env.API_KEY를 콘솔에 찍어보면 undefined가 떡하니 나오고, 분명 대시보드에서 설정했는데 왜 안 되는 건지 한참을 헤맸던 경험 — 아마 Workers 개발자라면 한 번쯤 겪어봤을 거다. 로컬에서는 잘 되다가 배포만 하면 터지는 경우, 반대로 프로덕션에서는 되는데 wrangler dev에서만 안 되는 경우, 심지어 둘 다 안 되는 경우까지. … 더 읽기

Cloudflare Workers fetch() 네트워크 에러 해결법 | 원인별 완벽 가이드

Workers fetch 에러

Workers에서 외부 API를 호출했는데, 응답이 돌아오지 않거나 알 수 없는 에러가 뜬 경험이 있으신가요? 저는 처음으로 Workers에서 fetch()를 써본 날, 로컬 Node.js에서는 멀쩡히 작동하던 API 호출이 Workers에서만 실패해서 한참을 헤맸습니다. 에러 메시지도 불친절하기 짝이 없어서, 구글링해도 딱 맞는 답을 찾기가 어려웠거든요. 그 경험 이후로 Workers의 fetch()가 일반적인 Node.js의 fetch()와 어떻게 다른지, 어떤 함정들이 있는지를 정리해 … 더 읽기

Cloudflare Workers wrangler deploy 실패 오류 해결법 | 에러별 완벽 가이드

wrangler deploy 실패

터미널에 wrangler deploy를 입력하고 엔터를 누르는 그 짧은 순간, 괜히 긴장되는 건 저만 그런 게 아닐 겁니다. 로컬에서 wrangler dev로 테스트할 때는 분명히 잘 돌아갔거든요. 그런데 배포만 하면 빨간 에러가 쏟아지는 상황. 처음 겪었을 때 솔직히 멘탈이 좀 흔들렸습니다. 에러 메시지를 복사해서 구글에 붙여넣기를 반복한 시간만 해도 꽤 될 겁니다. 그때의 삽질을 바탕으로, wrangler deploy … 더 읽기