웹훅 재시도 방치하면 워드프레스가 쓰레기통됩니다

Pipedeck 실제 화면

작성자

카테고리:

도입: 주말에 폭주한 웹훅, 쓰레기통이 된 워드프레스

자동 발행 파이프라인이 주는 자유와 그 대가

어느 주말 오후, 밀린 잠을 자고 일어나서 블로그 관리자 화면을 켰다가 식겁했다. 어제 밤에 예약해 둔 글 한 편이 아니라, 동일한 내용의 글이 7개나 줄지어 있었다. 원클립AI(https://oneclip.org)에서 자동으로 생성한 콘텐츠를 보내는 파이프라인이 꼬인 것이다. 자동화는 1인 운영자에게 자유를 주지만, 방심하면 이렇게 관리자 화면을 쓰레기통으로 만들어 버린다.

여러 개 복사된 AI 글을 보는 순간의 절망감

워드프레스 중복 발행 방지 자동화를 설정해 두었다고 자신했는데, 외부 AI API 지연이라는 변수를 예상하지 못했다. 글 7개를 일일이 지우면서, 플러그인에만 의존하던 내 방식이 얼마나 부실했는지 깨달았다.

워드프레스에 동일한 글이 중복 발행되는 주요 원인

웹훅 타임아웃과 자동 재시도의 덫

Make나 Zapier 같은 자동화 툴에서 워드프레스로 웹훅을 보낼 때, 응답이 지연되면 자동 재시도 로직이 트리거된다. 워드프레스 서버는 이미 글을 작성하고 있었지만, 외부 툴은 “응답이 없다”고 판단하고 똑같은 페이로드를 한 번 더 쏘아 붙인다. 10초 지연이 누적되면 같은 글이 3개, 5개씩 찍힌다.

WP-Cron의 중복 실행(Overlapping) 문제

워드프레스 기본 크론인 WP-Cron도 방심할 수 없다. 이전 작업이 외부 API 응답을 기다리며 끝나지 않은 상태에서 새로운 방문자가 들어오면, 크론 잡이 중복으로 실행된다. 자동 발행 파이프라인에서는 이 Overlapping이 치명적이다.

코드 수준에서 웹훅 및 크론 중복 실행 막기

크론 잠금(Cron Lock) 로직 구현하기

Transient API를 사용해 크론 작업이 실행 중일 때 잠금을 건다. 작업이 끝나기 전에 다른 스케줄이 들어오면 무시하는 구조다.

add_action('my_custom_cron_hook', 'my_cron_execution');
function my_cron_execution() {
    $lock = get_transient('my_cron_lock');
    if (false !== $lock) {
        return; // 이미 실행 중이면 종료
    }
    set_transient('my_cron_lock', 1, 5 * MINUTE_IN_SECONDS); // 5분 잠금

    // 실제 발행 로직 수행
    publish_ai_content();

    delete_transient('my_cron_lock'); // 완료 후 잠금 해제
}

초기 버전에서 잠금 해제 시점을 함수 맨 마지막에 두었더니, 외부 API 오류로 발행이 실패해도 잠금이 풀려버리는 대참사가 있었다. 정상적인 글마저 발행이 막혀서 급히 try-catch 문으로 묶고 예외 발생 시에도 안전하게 해제하도록 고쳤다.

웹훅 페이로드 해시 검증으로 중복 요청 필터링

들어오는 웹훅 요청 본문을 해시화해 임시 저장소에 비교한다. 이미 처리된 해시값이면 요청을 무시한다.

add_action('rest_api_init', function () {
    register_rest_route('aileego/v1', '/webhook', array(
        'methods' => 'POST',
        'callback' => 'handle_aileego_webhook',
    ));
});

function handle_aileego_webhook(WP_REST_Request $request) {
    $body = $request->get_body();
    $hash = md5($body);
    
    if (get_transient('aileego_hook_' . $hash)) {
        return new WP_REST_Response('Duplicate', 204);
    }
    set_transient('aileego_hook_' . $hash, 1, HOUR_IN_SECONDS);
    
    // 발행 처리 진행
    // ...
}
Pipedeck 실제 화면

REST API로 글을 넣을 때 이미 발행된 글인지 검사하고 스킵하기

메타 키(Meta Key)를 이용한 멱등성 보장

외부 툴에서 고유 ID를 메타 키로 보내도록 강제한다. 발행 전에 해당 메타 키를 가진 글이 있는지 WP_Query 메타 쿼리로 먼저 확인한다.

$existing = new WP_Query(array(
    'post_type' => 'post',
    'post_status' => 'any',
    'meta_query' => array(
        array(
            'key' => 'original_ai_content_id',
            'value' => $incoming_id,
            'compare' => '='
        )
    ),
    'posts_per_page' => 1
));

if ($existing->have_posts()) {
    return new WP_REST_Response('Already exists', 200); // 201 대신 200 반환
}

post_title 해시로 빠르게 중복 판별하기

메타 키가 없는 레거시 데이터를 위해 `post_title`을 기준으로 해시를 만들어 비교하는 방법을 덧붙인다. 데이터베이스 부하를 줄이기 위해 제목 자체를 해시 처리해 저장해 두면 빠르게 중복 판별이 가능하다.

Pipedeck 실제 화면

중복 발생 시 자동 삭제 및 알림 발송 파이프라인

초 단위로 생성된 중복 글 자동 휴지통 이동

방어 로직을 뚫고 중복 글이 적재되었을 때의 자가 정화 로직이다. `wp_postmeta`의 발행 시간 타임스탬프를 비교해 1분 이내에 동일 제목으로 발행된 글 중 가장 오래된 글만 남기고 휴지통으로 보낸다.

add_action('wp_insert_post', 'auto_purge_duplicates', 10, 3);
function auto_purge_duplicates($post_id, $post, $update) {
    if (wp_is_post_revision($post_id) || $post->post_status !== 'publish') return;

    $args = array(
        'post_type' => 'post',
        'post_status' => 'publish',
        'title' => $post->post_title,
        'posts_per_page' => 10,
        'date_query' => array(
            array('after' => '1 minute ago')
        )
    );
    
    $duplicates = new WP_Query($args);
    if ($duplicates->found_posts > 1) {
        // 가장 오래된 글 찾기
        // 나머지는 wp_delete_post($id, true) 또는 상태를 trash로 변경
    }
}

슬랙/텔레그램으로 1인 운영자에게 실시간 알림 보내기

정화가 발동하면 웹훅으로 내 슬랙 채널에 경고 알림을 보낸다. 이 최후의 보루 덕분에 잠을 자는 중에도 문제가 생겼다는 것을 즉시 인지하고 조치할 수 있다.

Pipedeck 실제 화면

아일리고가 실제로 사용하는 중복 방지 파이프라인 구성

Make(구 Integromat) → WP REST API → 자가 정화 로직

현재 춘천 원클립AI 스튜디오에서 굴리는 전체 아키텍처를 풀어놓는다. Make에서 AI 콘텐츠를 가공해 워드프레스로 보낼 때, 원본 콘텐츠의 고유 ID를 강제로 메타 값에 주입한다. 워드프레스 측 REST API 엔드포인트가 1차 필터링을 담당하고, WP-Cron 잠금 로직이 2차로 중복 실행을 막는다. 뚫린 경우를 대비한 자가 정화 스크립트가 3차 방어선이다.

1인 빌더의 자동화 아키텍처 운영 노하우

이 3단계 방어선을 세운 이후로는 중복 발행 사고가 사라졌다. 내 포트폴리오(https://wallenstein.dev)에 올라가는 서비스들을 관리하다 보니, 사고 한 번 나면 복구에 시간이 너무 오래 걸린다. 코드 수준에서 원천 차단하는 수밖에 없다.

요약 및 1인 자동화 운영자 행동 가이드

오늘 당장 적용할 중복 방지 3단계 체크리스트

  1. 웹훅 설정 확인: 외부 툴에서 보내는 페이로드에 고유 ID를 포함시키고, 응답 지연 시 무작정 재시도하지 않도록 타임아웃과 재시도 횟수 제한을 둔다.
  2. REST API 엔드포인트 방어: 워드프레스 측에서 고유 ID 메타 키로 중복 검사를 먼저 수행한다. 이미 있으면 201 대신 200이나 204로 스킵 처리한다.
  3. 크론 잠금 및 자가 정화: Transient API로 Overlapping을 막고, 1분 이내 동일 제목 발행 시 휴지통으로 보내고 알림을 쏘는 스크립트를 넣는다.

방어 로직 구축 후 확인해야 할 점

코드를 붙여넣었다면 의도적으로 같은 웹훅 요청을 두 번 쏴서 테스트해 본다. 두 번째 요청이 스킵 처리되는지, 서버 로그에 204 상태가 찍히는지 확인하라. 이 검증 과정을 건너뛰면 실제 장애 상황에서 로직이 작동하지 않을 수 있다.


글쓴이 정보

아일리고입니다. 자동화를 만들고 굴리며 겪은 일을 여기에 적습니다. 숏폼 영상은 ClipSquare 를 씁니다.

자주 묻는 질문

워드프레스에 같은 글이 여러 개 발행되는 주된 이유가 무엇인가요?

외부 자동화 툴에서 워드프레스로 웹훅을 보낼 때 응답이 지연되면, 툴이 요청이 실패했다고 판단해 동일한 페이로드를 재시도하는 경우가 가장 흔합니다. 또한 워드프레스 자체의 WP-Cron이 이전 작업이 끝나지 않은 상태에서 중복 실행(Overlapping)되는 것도 원인이 될 수 있습니다.

웹훅 중복 요청을 코드로 어떻게 막을 수 있나요?

들어오는 웹훅 요청 본문을 해시화하여 Transient API에 임시 저장하고, 동일한 해시값의 요청이 다시 들어오면 무시하는 방식을 사용합니다. 이렇게 하면 이미 처리된 요청을 필터링하여 중복 발행을 원천 차단할 수 있습니다.

REST API로 글을 발행할 때 중복을 방지하려면 어떻게 해야 하나요?

외부 툴에서 고유 ID를 메타 키로 전송하도록 강제하고, 발행 전에 WP_Query로 해당 메타 키를 가진 글이 이미 존재하는지 먼저 확인해야 합니다. 글이 존재하면 201 대신 200을 반환하여 외부 툴의 재시도 로직을 끊어버리는 것이 핵심입니다.

워드프레스 크론 작업이 중복 실행되는 것은 어떻게 방지하나요?

Transient API를 활용해 크론 작업이 실행 중일 때 잠금을 거는 방식으로 방지할 수 있습니다. 작업 시작 시 잠금을 설정하고 완료 후 해제하며, 예외 발생 시에도 잠금이 풀리도록 try-catch 문으로 안전하게 처리하는 것이 중요합니다.