Vercel 크론(Cron) 설정 완전 정리

1️⃣ 기본 구조 및 문법

Vercel은 표준 Cron 표현식(* * * * *)을 그대로 사용합니다.

┌───────────── 분 (minute, 0–59)
│ ┌───────────── 시 (hour, 0–23)
│ │ ┌───────────── 일 (day of month, 1–31)
│ │ │ ┌───────────── 월 (month, 1–12)
│ │ │ │ ┌───────────── 요일 (day of week, 0–6, 일요일=0)
│ │ │ │ │
* * * * *

💡 예시표

표현식	실행 주기
`* * * * *`	매분 실행
`0 * * * *`	매시간 정각 실행
`0 9 * * *`	매일 오전 9시 실행
`30 2 * * *`	매일 새벽 2시 30분 실행
`0 /3 * *`	3시간마다 실행
`/5 * * *`	5분마다 실행
`0 9-18 * * 1-5`	월~금 9시~18시 매시간 실행
`15 14 1 * *`	매월 1일 14시 15분 실행

🔹 특수기호 정리

기호	설명	예시
`*`	모든 값	`* * * * *` → 매분
`,`	여러 값 지정	`0,15,30,45 * * * *`
`-`	범위 지정	`0 9-17 * * *`
`/`	주기 지정	`/10 * * *`

2️⃣ 자주 사용하는 주기별 설정 예시

🕒 3시간 간격으로 실행

{
  "crons": [
    {
      "path": "/api/naver-ads-keyword-cpc-adjuster-cron-version",
      "schedule": "0 */3 * * *"
    }
  ]
}

0 */3 * * *

→ 매일 0분 기준으로 3시간 간격(0시, 3시, 6시, 9시, 12시, 15시, 18시, 21시)에 실행됩니다.

즉, 하루 총 8회 실행됩니다.

🗓 특정 요일·시간대 예시

0 9-18 * * 1-5 → 월~금 9시~18시 매시간 정각 실행
*/15 14-16 * * 3 → 수요일 14~16시, 15분마다 실행

🕗 특정 시간 범위만 제어

*/30 8-20 * * * → 매일 8시~20시, 30분마다 실행
* * * * * → 매일 매분 실행

✅ 정리

Vercel Cron은 분·시·일·월·요일 단위로 자유롭게 범위를 지정할 수 있으며, 요일 포함·제외 설정도 가능합니다.

3️⃣ 크론 중단 및 비활성화 방법

Vercel의 vercel.json 은 주석 처리나 비활성화 속성을 직접 지원하지 않습니다.

대신 다음 방법 중 하나를 사용해야 합니다.

방법 ① Dashboard에서 크론 항목 삭제

가장 확실하고 안전한 방법입니다.

Vercel 프로젝트 Dashboard 에서 Cron 항목을 삭제하면 즉시 비활성화됩니다.

방법 ② `.env` 설정으로 내부 제어

API 내부에서 ENABLE_CRON 값을 확인하여 동작 여부를 제어할 수 있습니다.

export default async function handler(req, res) {
  const ENABLE_CRON = process.env.ENABLE_CRON === 'true';

  if (!ENABLE_CRON) {
    return res.status(200).send("Cron is temporarily disabled.");
  }

  // 실제 작업 수행
}

.env