상태 전이 테스트란？상태 전이도·전이표의 작성법과 실례를 알기 쉽게 해설【Playwright 대응】

상태 전이 테스트란 시스템이 가진 「상태」와 「상태를 변화시키는 이벤트」를 정리하여 전이가 올바르게 동작하는지를 검증하는 테스트 설계 기법입니다. 로그인 플로우·EC 카트·예약 시스템 등 상태를 가진 시스템의 테스트에서 특히 효과를 발휘합니다.

상태 전이 테스트를 사용하면 「정상적인 전이가 올바르게 동작하는가」뿐만 아니라 「있어서는 안 되는 전이가 올바르게 거부되는가」까지 체계적으로 테스트할 수 있어 플로우 계열 버그를 근본적으로 방지할 수 있습니다.

「로그아웃 상태에서 주문 확정 버튼을 누르면 어떻게 될까？」「취소 완료된 주문을 다시 취소할 수 있어버린다？」——이런 「있어서는 안 되는 조작」의 테스트를 놓치고 있지 않으신가요？

• 정상 플로우만 테스트하여 비정상적인 상태 전이가 누락된다
• 어떤 상태에서 어떤 조작이 가능한지가 정리되지 않는다
• 플로우가 복잡해질수록 테스트 케이스가 발산해버린다

상태 전이 테스트는 이런 문제를 해결하는 기법입니다. 이 글에서는 개념·상태 전이도·상태 전이표의 작성법부터 Playwright E2E 테스트로의 응용까지 한 번에 해설합니다.

상태 전이 테스트란？

상태 전이 테스트란 「시스템이 가진 상태」「상태를 변화시키는 이벤트（조작）」「전이 후 상태」「실행되는 액션」을 정리하여 모든 전이가 올바르게 동작하는지를 검증하는 테스트 설계 기법입니다.

예를 들어 EC 사이트의 주문 플로우에서는 「카트 미추가」→「카트 추가 완료」→「주문 확정」→「발송 완료」→「수령 완료」라는 상태 변화가 발생합니다. 상태 전이 테스트는 이 흐름을 도표나 표로 정리하여 모든 패턴을 빠짐없이 테스트합니다.

상태 전이 테스트의 기본 요소란？

상태 전이 테스트를 설계하려면 다음 4가지 요소를 정리합니다.

상태 전이도（State Diagram）의 작성법이란？

상태 전이도는 상태를 원（○）·전이를 화살표（→）·이벤트를 라벨로 나타낸 도표입니다. 전체 흐름을 직관적으로 파악할 수 있습니다.

※ 상태는 「원」、전이는 「화살표」、이벤트는 「라벨」로 표현합니다. 도표를 처음 읽는 경우에는 먼저 원（상태）을 확인하고 화살표（전이）를 따라가 보세요.

상태 전이도의 장점

• 전체 흐름을 한눈에 파악할 수 있다：상태와 전이의 관계가 시각적으로 이해된다
• 팀 설명이 쉬워진다：개발·QA·비즈니스 측이 공통 인식을 가질 수 있다
• 누락 발견에 도움이 된다：도표를 그리는 과정에서 「이 상태로의 전이가 없네？」라는 깨달음이 생긴다

상태 전이표（State Transition Table）의 작성법이란？

상태 전이표는 상태 전이도를 표 형식으로 변환한 것입니다. 각 상태×각 이벤트의 조합으로 「전이 대상」 또는 「무효（—）」를 기입함으로써 테스트 케이스를 망라적으로 도출할 수 있습니다.

실례：로그인 플로우의 상태 전이표

표 중의 「—」는 그 이벤트가 현재 상태에서는 무효（발생해서는 안 되거나 발생해도 상태가 변하지 않는）임을 나타냅니다. 이 「—」 부분이 바로 「무효 전이 테스트」의 테스트 케이스가 됩니다.

실례：EC 사이트 주문 플로우

더 실무에 가까운 예로서 EC 사이트의 주문 플로우를 테스트 케이스에 반영해 봅니다.

✅는 정상 전이 테스트（올바른 조작이 올바르게 동작한다），❌는 무효 전이 테스트（무효 조작이 올바르게 거부된다）를 나타냅니다. 양쪽을 커버함으로써 플로우 전체의 품질을 담보할 수 있습니다.

Playwright × pytest에의 응용

상태 전이 테스트는 Playwright × pytest의 E2E 테스트와 매우 궁합이 좋습니다. 「각 상태를 fixture·각 전이를 테스트 함수」로 구현하는 것이 실무의 베스트 프랙티스입니다.

폴더 구성 예시

tests/
├── conftest.py              # fixture 정의（상태 준비）
└── e2e/
    └── test_order_flow.py   # 주문 플로우의 상태 전이 테스트

conftest.py：상태를 fixture로 준비한다

import pytest
from playwright.sync_api import Page

@pytest.fixture
def logged_in_page(page: Page):
    """상태：로그인 중（로그인 완료 페이지를 반환）"""
    page.goto("localhost:3000/login")
    page.fill("#username", "test_user")
    page.fill("#password", "secret_pass")
    page.click("#login-btn")
    page.wait_for_url("**/dashboard")
    return page

@pytest.fixture
def cart_added_page(logged_in_page: Page):
    """상태：카트 추가 완료（로그인 완료＋상품 추가 완료）"""
    logged_in_page.goto("localhost:3000/products/1")
    logged_in_page.click("#add-to-cart")
    logged_in_page.wait_for_selector(".cart-badge")
    return logged_in_page

test_order_flow.py：전이를 테스트 함수로 구현한다

from playwright.sync_api import Page, expect

# TC-01：카트 미추가 → 상품 추가 → 카트 추가 완료
def test_add_item_to_cart(logged_in_page: Page):
    logged_in_page.goto("localhost:3000/products/1")
    logged_in_page.click("#add-to-cart")
    expect(logged_in_page.locator(".cart-badge")).to_have_text("1")

# TC-02：카트 추가 완료 → 구매 확정 → 주문 확정
def test_confirm_order(cart_added_page: Page):
    cart_added_page.goto("localhost:3000/cart")
    cart_added_page.click("#checkout-btn")
    expect(cart_added_page.locator(".order-status")).to_have_text("주문 확정")

# TC-04：카트 미추가 → 구매 확정（무효 전이）
def test_checkout_without_cart(logged_in_page: Page):
    logged_in_page.goto("localhost:3000/cart")
    # 카트가 비어 있을 때는 구매 버튼이 비활성화되어 있는지 확인
    expect(logged_in_page.locator("#checkout-btn")).to_be_disabled()

# TC-05：취소 완료 → 재취소（무효 전이）
def test_cancel_already_cancelled_order(logged_in_page: Page):
    logged_in_page.goto("localhost:3000/orders/cancelled-order")
    # 취소 완료 주문에는 취소 버튼이 존재하지 않는 것을 확인
    expect(logged_in_page.locator("#cancel-btn")).not_to_be_visible()

⚠️ 상태 전이 테스트에서 자주 있는 실패 패턴 4선

실무에서 상태 전이 테스트를 설계할 때 빠지기 쉬운 실패를 소개합니다.

FAQ

📋 이 글의 정리

상태 전이 테스트의 최대 가치는 「정상 플로우만으로는 알 수 없는 버그」를 체계적으로 발견할 수 있는 점입니다. 먼저 로그인 플로우나 주문 플로우 등 가까운 시스템의 상태 전이도를 1장 그려보는 것부터 시작하세요. 도표를 그리는 것만으로 「이 전이 테스트, 하지 않았었다！」라는 깨달음이 반드시 생깁니다.