---
title: 단계별 시스템 디버깅 체크리스트 (L1~L3)
category: Software [[Architecture|Architecture]]
tags: [Debugging, Troubleshooting, Checklist, Process]
created: 2026-04-20
---

# 단계별 시스템 디버깅 체크리스트 (The Diagnostic Flowchart)

## 🔍 L1: 환경 및 무결성 검증 (Low Level)
- **대상**: 404 Error, Syntax Error, 파일 경로.
- **목표**: **'실행 가능한 물리적 토대'**가 마련되어 있는가?
- **필수 조치**: 강제 새로고침(Ctrl + F5), 서버 재시작(Restart Ritual).

## 🔍 L2: 통신 및 데이터 흐름 검증 (Communication)
- **대상**: `onmessage`, `postMessage`, 비동기 처리.
- **목표**: 메시지가 의도한 대로 흐르고 있는가?
- **필수 조치**: 데이터 흐름 추적(`console.log`), 핸들러 동작 유무 확인.

## 🔍 L3: 논리 엔진 및 비즈니스 검증 (High Level)
- **대상**: 비즈니스 로직, 수학적 공식, 물리 엔진.
- **목표**: 코드가 논리적으로 무결한가?
- **필수 조치**: 최소 실행 예제(MRE)를 통한 격리 테스트.

## 🔗 연결된 지식
- [[Tetris_Project_Retrospective|Tetris_Project_Retrospective]]
- [[DevOps_Environment_Setup|DevOps_Environment_Setup]]