# 워크플로우 실행 문제 해결 - 레이스 컨디션

레이스 컨디션(Race Condition)은 두 개 이상의 업데이트가 동시에(같은 초 내에) 발생할 때 생기는 현상입니다. 두 변경사항이 "경쟁"하면서 원래 순서와 다르게 실행되거나, 실행되었다고 표시되지만 실제로는 실행되지 않는 문제가 발생할 수 있습니다.

## 목차

* [메시지 딥링크를 통해 정확한 실행 내역 열기](#메시지-딥링크를-통해-정확한-실행-내역-열기)
* [레이스 컨디션 예시: 태그 추가가 실행되었지만 실제로는 추가되지 않은 경우](#레이스-컨디션-예시-태그-추가가-실행되었지만-실제로는-추가되지-않은-경우)
* [레이스 컨디션 방지 방법](#레이스-컨디션-방지-방법)

## 메시지 딥링크를 통해 정확한 실행 내역 열기

영향받은 메시지에서 직접 실행 내역을 열면 타이밍 문제를 진단하기 전에 올바른 실행, 연락처, 타임스탬프를 확인할 수 있습니다.

단계:

* Conversations(대화) 메뉴로 가서 영향받은 메시지가 있는 대화를 엽니다.
* 해당 메시지의 메시지 세부정보를 엽니다.
* Workflow (딥링크)를 클릭하여 컨텍스트가 로드된 실행 세부정보를 엽니다.
* 타임스탬프와 액션 순서를 검토하여 여러 액션이 같은 초에 실행되었는지 확인합니다.

**대안 방법:**

메시지 세부정보에서 워크플로우 링크를 사용할 수 없는 경우, 로그에서 실행 내역을 엽니다:

* Workflows(워크플로우) → 워크플로우 열기 → Logs(로그)로 이동한 후 연락처와 메시지 전후 시간으로 필터/검색합니다.

***

## 레이스 컨디션 예시: 태그 추가가 실행되었지만 실제로는 추가되지 않은 경우

이 예시에서는 워크플로우 실행 로그상으로 해당 연락처에 태그가 성공적으로 추가된 것을 확인할 수 있습니다.

![태그 추가 실행 로그](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/48237097817/original/pPEyoJgImK3T2gGbzJKB67cfk97rECsmrQ.png?1657131948)

하지만 연락처 레코드를 확인해보면 태그가 없는 것을 볼 수 있습니다.

![연락처 레코드에 태그 없음](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/48237098616/original/QV-c-v9lQ1vmsqrWFtQJxnTd9FnvBUttZQ.png?1657132211)

실행 로그로 돌아가서 시간을 자세히 살펴보겠습니다. "Add to workflow"와 "Add Tag" 액션이 정확히 같은 초에 실행되었는데, 이것이 바로 레이스 컨디션입니다.

![같은 시간에 실행된 액션들](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/48237097905/original/PtKVYprrQGKLzBww-ZXcYyVETqRuSFn5pg.png?1657131977)

***

## 레이스 컨디션 방지 방법

레이스 컨디션을 해결하려면 1분 Wait(대기) 액션을 추가하면 됩니다.

<https://www.loom.com/share/f4adf9e14dab429da0cc2fedbb7e5e36>

![1분 대기 액션 추가](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155037771738/original/aZsqCC0OAIfQkSQqUbLor31c9DWXbFaYeg.png?1733350591)

1분 대기 액션을 추가하면 레이스 컨디션이 발생할 가능성이 없어집니다.

![대기 액션으로 해결된 워크플로우](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155037771768/original/dfxKTUGbzhTGDHHNdPEUqtvKhpVqmyF86A.png?1733350650)

***

*원문 최종 수정: Mon, 2 Feb, 2026 at 10:44 AM* *Hyperclass 사용 가이드 — hyperclass.ai*


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://hyperclass.gitbook.io/hyperclass-docs/workflows/workflows-pro-plan-new-pricing-tiers/troubleshooting-workflow-executions-race-conditions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
