WordPress Cron이 작동하지 않나요? 예약 작업과 누락된 게시물을 해결하는 방법
WordPress 예약 게시물이 게시되지 않나요? WP-Cron 문제를 진단하고, 예약 이벤트를 검사하며, 루프백 오류를 수정하고, 신뢰할 수 있는 서버 크론 작업을 단계별로 구성하는 방법을 배워보세요.
워드프레스 크론이 작동하지 않나요? 예약 작업과 놓친 게시물을 어떻게 수정하나요?
오전 9시에 워드프레스 게시물을 예약했습니다. 그런데 오전 9시 30분에도 아직 나타나지 않았습니다.
또는 아마 WooCommerce 이메일이 늦게 도착하거나, 예약된 백업이 시작되지 않았거나, 플러그인이 백그라운드 작업이 지연되었음을 보고할 수 있습니다.
이 문제들은 종종 WP-Cron, 워드프레스의 내장 작업 예약 시스템에 공통점이 있습니다.
WP-Cron은 호스팅 서버의 작업 스케줄러에 접근할 필요 없이 작동하므로 편리합니다. 하지만 전통적인 시스템 크론 작업과 달리, 백그라운드에서 계속 실행되지는 않습니다.
이 가이드에서는 WP-Cron이 어떻게 작동하는지, 지연된 작업의 원인을 어떻게 확인하는지, 그리고 필요할 때 기본 트리거 메커니즘을 신뢰할 수 있는 서버 크론 작업으로 바꾸는 방법을 배웁니다.
공유 호스팅과 명령줄 접근이 가능한 서버 모두를 다룹니다.
1. WP-Cron이 실제로 어떻게 작동하는지
전통적인 Linux 크론 데몬은 웹사이트 트래픽과 독립적으로 자체 일정을 확인합니다.
WP-Cron은 다릅니다. 워드프레스는 일반적인 웹사이트 활동 중에 예약된 작업을 확인하고, 적절한 때 wp-cron.php으로 요청을 시작하려고 시도합니다.
즉, 예약된 이벤트가 정확한 예약 시간에 실행될 것으로 보장되지 않습니다.
웹사이트가 마지막 방문자를 오후 10시에 받았다고 가정해 보세요. 백업이 오전 2시에 예약되었지만, 밤 동안 아무도 웹사이트를 방문하지 않았습니다.
백업이 워드프레스가 자체 예약 시스템을 트리거하는 다른 요청을 받을 때까지 시작되지 않을 수 있습니다.
두 예약 방식이 다르게 작동하는 방법
기본 WP-Cron: 방문자 요청 → 워드프레스가 이벤트 확인 → 기한이 지난 작업 시작. 워드프레스 요청에 의존합니다.
서버 크론: 서버 스케줄러 → 5분마다 실행 → 기한이 지난 작업 시작. 방문자 트래픽과 독립적으로 작동합니다.
서버 크론 작업은 워드프레스가 예약된 이벤트를 저장하는 방식을 변경하지 않습니다. 단지 더 예측 가능한 방식으로 확인하고 실행할 수 있게 해 줍니다.
2. 어떤 것이든 변경하기 전에 먼저 증상을 인식하세요
모든 지연된 워드프레스 작업이 WP-Cron 때문에 발생하는 것은 아닙니다.
먼저 실제 증상을 확인하기 시작하세요.
| 증상 | 가능한 설명 |
|---|---|
| 예약된 게시물에 "놓친 일정" 표시 | 크론 트리거 지연 또는 실패 |
| 예약된 이메일이 늦게 도착함 | 크론 지연, 큐 처리 또는 메일 전달 문제 |
| 자동 백업이 시작되지 않음 | 누락된 이벤트, 크론 실패 또는 백업 플러그인 오류 |
| WooCommerce 작업이 지연됨 | Action Scheduler 처리 문제 |
| Site Health에서 loopback 오류 보고 | 워드프레스가 자체 URL을 안정적으로 요청할 수 없음 |
| 웹사이트 방문 후에만 작업 실행 | 트래픽 의존적 크론 트리거 |
중요한 차이는 시작되지 않은 작업과 시작했지만 실패한 작업입니다.
WP-Cron을 서버 스케줄러로 교체하면 첫 번째 문제를 해결할 수 있습니다. 하지만 깨진 플러그인, 사용할 수 없는 데이터베이스 또는 실패하는 메일 서비스를 자동으로 고치지는 않습니다.
3. 변경하기 전에 먼저 WordPress Site Health 확인
구성 파일을 만지기 전에 워드프레스 관리자 인터페이스를 열어 보세요.
- 도구 → Site Health로 이동합니다.
- Status 탭을 엽니다.
- 예약된 이벤트 또는 loopback 요청과 관련된 경고를 찾습니다.
- 변경하기 전에 정확한 메시지를 기록합니다.
loopback 요청은 워드프레스가 자체 웹사이트에 대해 만드는 요청입니다.
이러한 요청이 실패하면 예약된 작업이 제대로 트리거되지 않을 수 있습니다.
일반적인 원인으로는 잘못된 웹사이트 URL, DNS 확인 문제, SSL 인증서 문제, HTTP 인증, 방화벽 제한 또는 플러그인 및 테마 충돌이 있습니다.
예시: 비밀번호로 보호된 스테이징 사이트
워드프레스 스테이징 환경을 다음에 만들었다고 가정해 보세요.
https://staging.example.com
스테이징 사이트는 HTTP Basic Authentication을 필요로 합니다.
워드프레스는 자체 wp-cron.php endpoint를 요청하려고 하지만, 서버는 요청이 인증되지 않았기 때문에 HTTP 401을 반환합니다.
문제가 예약된 작업 자체인지는 아니어야 합니다. 작업을 트리거해야 할 요청이 거부되고 있습니다.
이 상황에서는 공개 HTTP loopback 경로를 피할 수 있는 서버 측 CLI 스케줄러를 사용하거나, 워드프레스의 내부 요청이 올바르게 작동하도록 환경을 구성할 수 있습니다.
스테이징 사이트의 비밀번호 보호를 cron을 작동시키기 위해 제거하지 마세요.
4. WP-CLI로 예약된 작업 검사
SSH 접근과 WP-CLI가 설치되어 있다면 스케줄러를 직접 검사할 수 있습니다.
먼저 워드프레스 설치 디렉터리로 이동합니다.
cd /path/to/wordpress
다음으로 예약된 이벤트를 나열합니다.
wp cron event list
hook 이름, 다음 예약 실행 시간, 반복 정보 같은 정보를 볼 수 있습니다.
기계 판독 가능한 출력에 대해:
wp cron event list --fields=hook,next_run_gmt,recurrence --format=json
무엇을 확인해야 하나요?
다음 실행 시간이 과거인 이벤트에 주의를 기울이세요.
지연된 이벤트는 유용한 경고 신호일 수 있지만, 하나의 지연된 이벤트만으로 전체 스케줄러가 고장 났다고 단정할 수는 없습니다.
관련 없는 hook들이 여러 개 지연되고 있는지 확인하세요. 그렇다면 전역 트리거 메커니즘을 조사하세요.

만약 하나의 플러그인의 이벤트만 영향을 받는다면, 해당 플러그인을 먼저 검사하세요.
기한이 지난 작업 수동 실행
스테이징 환경에서 또는 운영 환경에서 문제를 확인한 후 다음을 실행하세요.
wp cron event run --due-now
이 명령은 현재 기한이 지난 이벤트를 워드프레스에 실행하도록 요청합니다.
조심하세요: 이 명령은 실제 작업을 수행합니다. 예약된 콘텐츠를 게시하거나, 메시지를 보내거나, 백업을 시작하거나, 전자상거래 작업을 트리거할 수 있습니다.
무해한 진단 미리보기가 아닙니다.
성공적으로 완료했지만 이후 작업이 다시 지연될 수 있다면, 자동 트리거 메커니즘이 문제일 수 있습니다.
5. 트래픽 의존적인 WP-Cron을 서버 크론 작업으로 대체
예약 작업이 중요한 프로덕션 웹사이트에는 서버 크론 작업이 종종 더 나은 선택입니다.
목표는 간단합니다:
- 일반 페이지 요청에서 워드프레스가 WP-Cron을 자동으로 실행하려고 하지 않도록 중단합니다.
- 서버에 정기 간격으로 기한이 지난 이벤트를 처리되도록 요청합니다.
1단계: wp-config.php 편집
wp-config.php의 백업을 만듭니다.
다음 줄 앞에 다음 설정을 추가하세요:
define('DISABLE_WP_CRON', true);
이것은 워드프레스의 기본 자동 크론 생성을 비활성화합니다. 예약된 이벤트를 삭제하지는 않습니다.
2단계: 호스팅 서버에서 예약 작업 생성
호스팅 컨트롤 패널을 열고 크론 작업 스케줄러를 찾습니다.
일반적인 워드프레스 설치에 대해서는 다음 PHP CLI 명령과 유사한 것을 예약할 수 있습니다:
/usr/bin/php /home/account/public_html/wp-cron.php
PHP 실행 파일 경로와 워드프레스 설치 경로를 호스트가 제공한 실제 값으로 바꾸세요.
명령은 올바른 PHP 버전을 실행해야 하고 워드프레스 파일에 읽기 권한이 있어야 합니다.
WP-CLI가 설치되어 있다면 다음 대안도 있습니다:
cd /home/account/public_html && /usr/local/bin/wp cron event run --due-now
이 대안은 WP-CLI를 통해 기한이 지난 워드프레스 이벤트를 명시적으로 처리합니다.
같은 설치에 대해 여러 개의 독립적인 크론 작업을 구성하는 것보다 하나의 예약 방법을 사용하세요.
3단계: 적절한 간격 선택
일반적인 웹사이트에는 5분이 합리적인 시작점입니다.
| 실행 간격 | 일일 스케줄러 호출 수 | 최대 폴링 지연* | 예시 crontab 표현식 |
|---|---|---|---|
| 1분 | 1,440 | 1분 | * * * * * |
| 5분 | 288 | 5분 | */5 * * * * |
| 10분 | 144 | 10분 | */10 * * * * |
| 15분 | 96 | 15분 | */15 * * * * |
| 30분 | 48 | 30분 | */30 * * * * |
*정상 작동하는 스케줄러와 짧은 실행 작업을 가정합니다. 실제 실행은 서버 부하나 장기 실행 콜백으로 인해 지연될 수 있습니다.
예를 들어 5분마다:
*/5 * * * *
1분 간격은 더 자주 확인을 수행하지만 모든 웹사이트에 필요한 것은 아닙니다.
저트래픽 블로그에는 5분 또는 10분이면 충분할 수 있습니다. 바쁜 전자상거래 매장에는 백그라운드 작업량에 따라 더 자주 처리가 필요할 수 있습니다.
4단계: 결과 테스트
서버 작업을 구성한 후 최소 두 번의 예약 간격을 기다리세요.
그런 다음 이벤트 목록을 다시 검사하세요:
wp cron event list
이전에 지연된 이벤트가 처리되었는지 확인하세요.
호스팅 크론 로그도 확인하세요.
또한 실제 비즈니스 작업을 확인하세요: 예약된 테스트 게시물, 무해한 유지보수 작업 또는 관찰 가능한 결과가 있는 다른 작업.
6. 호스팅이 SSH 접근을 제공하지 않을 경우
많은 공유 호스팅 플랜에서 여전히 서버 크론 작업을 구성할 수 있습니다.
일부 호스팅 패널은 예약된 URL 요청을 지원합니다, 예를 들어:
https://example.com/wp-cron.php
다른 호스팅 패널은 대화형 SSH 터미널 없이 PHP 명령 실행을 제공합니다.
지원되는 경우 PHP CLI 작업을 선호하세요. 예약된 HTTP 요청은 리디렉션, 접근 제한, 보안 규칙 또는 네트워크 문제로 인해 영향을 받을 수 있습니다.
호스팅 패널이 HTTP 요청만 지원한다면, endpoint에 도달 가능하고 요청이 실제로 기한이 지난 작업을 트리거하는지 확인하세요.
HTTP 200 응답을 받았다고 해서 모든 예약된 콜백이 성공적으로 완료되었다고 가정하지 마세요.

7. 안전한 테스트 이벤트 만들기
개발자를 위해 작은 테스트 플러그인이 기존 플러그인과 독립적으로 예약 시스템이 작동하는지 확인하는 데 도움이 될 수 있습니다.
다음 파일을 만드세요:
wp-content/plugins/ceikay-cron-test/ceikay-cron-test.php
다음을 추가하세요:
<?php
/**
* Plugin Name: CeiKay Cron Test
* Description: Temporary diagnostic cron event.
*/
if (!defined('ABSPATH')) {
exit;
}
add_action('ceikay_cron_test', function () {
error_log(
'CeiKay cron test executed at ' .
gmdate('Y-m-d H:i:s') .
' UTC'
);
});
register_activation_hook(__FILE__, function () {
if (!wp_next_scheduled('ceikay_cron_test')) {
wp_schedule_event(
time() + 60,
'hourly',
'ceikay_cron_test'
);
}
});
register_deactivation_hook(__FILE__, function () {
wp_clear_scheduled_hook('ceikay_cron_test');
});
워드프레스 관리자 인터페이스에서 플러그인을 활성화하세요.
이 플러그인은 시간별 이벤트를 등록하고 PHP 오류 로그에 간단한 진단 메시지를 기록합니다. 이메일을 보내거나, 콘텐츠를 변경하거나, 외부 네트워크 요청을 하지 않습니다.
첫 번째 이벤트는 활성화 후 약 1분 후에 예약됩니다.
활성화 직후 WP-CLI로 테스트하려면:
wp cron event run ceikay_cron_test
다음과 비슷한 메시지가 PHP 오류 로그에 있는지 확인하세요:
CeiKay cron test executed at 2026-11-18 07:30:00 UTC
타임스탬프는 예시일 뿐입니다.
자동 스케줄러를 테스트하려면 수동으로 hook을 실행하는 대신 이벤트가 기한을 지나고 설정된 크론 메커니즘이 처리하도록 기다리세요.
테스트가 완료되면 진단 플러그인을 비활성화하고 삭제하세요.
8. 문제 해결: 크론 작업은 실행되지만 작업이 여전히 실패함
작동하는 크론 트리거는 시스템의 일부일 뿐입니다.
서버 스케줄러가 성공적으로 실행되지만 워드프레스 작업이 계속 실패한다면 다음 진단 표를 사용하세요.
| 문제 | 확인할 항목 | 제안되는 조치 |
|---|---|---|
| 예약된 이벤트가 나열되지 않음 | 플러그인이 자신의 hook을 등록하지 않았을 수 있음 | 플러그인 활성화 및 예약 코드 확인 |
| 이벤트가 계속 지연됨 | 서버 작업이 실행되지 않을 수 있음 | 크론 로그, PHP 경로 및 권한 확인 |
| PHP 치명적 오류 | 작업 콜백 또는 플러그인 실패 | PHP 오류 로그 및 스택 추적 검사 |
| HTTP 401 또는 403 | 인증 또는 방화벽 | loopback 접근 제한 검토 |
| HTTP 500 | 애플리케이션 또는 서버 실패 | PHP/서버 로그 검사 |
| 이벤트는 실행되지만 이메일이 도착하지 않음 | 메일 전송 경로 문제 | SMTP 또는 메일 전달 로그 확인 |
| 중복 실행 | 중복 일정 또는 겹치는 프로세스 | hook, 인수 및 잠금 검사 |
| WooCommerce 작업이 지연됨 | Action Scheduler 백로그 | 예약된 작업 인터페이스 및 개별 실패 검사 |
지연된 이벤트를 무조건 삭제하지 마세요
모든 고장난 것처럼 보이는 이벤트를 제거하는 유혹을 느낄 수 있습니다.
하지 마세요.
이벤트는 합법적인 예약 결제 관련 작업, 주문 처리 작업, 이메일 전달 또는 백업을 나타날 수 있습니다.
이벤트를 삭제하면 기반 문제를 해결하지 않고 예약된 작업을 제거할 수 있습니다.
WP-CLI는 이벤트를 삭제하는 명령을 제공하지만, hook을 식별하고 목적을 이해한 후에만 사용해야 합니다.
9. 자체 플러그인에서 예약된 이벤트 중복을 피하세요
워드프레스 플러그인을 개발한다면, 같은 반복 이벤트를 계속 등록하는 흔한 실수가 있습니다.
예를 들어 페이지 로드마다 이벤트를 예약하지만 이미 존재하는지 확인하지 않는 경우입니다.
올바른 접근은 먼저 확인하는 것입니다:
if (!wp_next_scheduled('myplugin_daily_cleanup')) {
wp_schedule_event(
time() + HOUR_IN_SECONDS,
'daily',
'myplugin_daily_cleanup'
);
}
그 다음 콜백을 별도로 등록하세요:
add_action('myplugin_daily_cleanup', function () {
// Perform a small, bounded maintenance task.
});
이벤트가 인수를 받는다면, 예약, 확인, 제거 시 일관된 인수를 사용하세요. 워드프레스는 hook과 인수를 사용하여 예약된 이벤트를 구별합니다.
또한 실행 시간을 고려하세요. 수천 개의 레코드를 하나의 요청으로 처리하는 작업은 PHP 실행 시간 또는 메모리를 소진할 수 있습니다.
대용량 작업의 경우 작은 배치로 데이터를 처리하고, 작업이 재시도될 수 있도록 만들고, 진행 상황을 기록하세요.
10. 신뢰할 수 있는 워드프레스 스케줄러에 대한 실용 체크리스트
문제가 해결되었다고 생각하기 전에 다음 사항을 확인하세요:
- [ ] WordPress Site Health에 설명할 수 없는 예약 또는 loopback 오류가 없습니다.
- [ ] 예상된 예약 hook이 존재합니다.
- [ ] 서버 크론이 의도된 간격으로 실행됩니다.
- [ ]
DISABLE_WP_CRON은 대체 트리거가 준비된 후에만 구성합니다. - [ ] 크론 작업이 올바른 PHP 실행 파일과 워드프레스 경로를 사용합니다.
- [ ] 실제 예약 작업이 성공적으로 완료됩니다.
- [ ] 작업이 실패할 때 로그를 확인할 수 있습니다.
- [ ] 중복된 스케줄러 구성이 활성화되지 않았습니다.
- [ ] 중요한 작업에 대한 모니터링 또는 실패 알림이 있습니다.
신뢰할 수 있는 스케줄러는 실행되는 것만 아니라, 실패를 식별하고 조사할 수 있는 것이 중요합니다.
11. 최종 생각: 언제 서버 크론을 사용해야 하나요?
가끔 방문하고 시간에 민감한 자동화가 없는 작은 개인 블로그라면, 기본 WP-Cron도 완벽하게 적합할 수 있습니다.
하지만 웹사이트가 예약된 게시물, 백그라운드 유지보수, 전자상거래 처리 또는 기타 반복 작업에 의존한다면, 서버 크론 작업을 고려할 가치가 있습니다.
개선점은 서버 크론이 모든 워드프레스 플러그인을 마법처럼 만드는 것은 아니라는 것입니다. 서버 크론은 예약된 이벤트를 트리거하기 위해 들어오는 웹사이트 요청에 의존하는 중요한 불확실성을 제거합니다.
실제 실패를 진단하고, 예약된 이벤트를 검사한 다음, 그때서야 트리거 메커니즘을 변경하세요.
이 접근 방식은 무엇이 잘못되었는지 모르고 다른 플러그인을 설치하거나 구성 설정을 수정하는 것보다 더 안전합니다.