클러스터 C2: API 디버깅
OpenAPI 디버깅 워크플로 체크리스트
많은 API 버그는 코드 자체보다 스펙, 클라이언트, 서비스 구현 사이의 계약 불일치에서 시작됩니다.
순서대로 좁혀야 합니다
먼저 어떤 operation 을 호출했는지 확정한 뒤 path 파라미터, query, headers, body 의 실제 구조를 비교합니다.
계약 자체가 어긋난 상태에서 로그만 보면 원인 파악이 더 어려워집니다.
재현과 비교는 원본 데이터로
- 재현 가능한 도구로 요청을 다시 보내고 headers 와 body 를 보관합니다.
- 실제 상태 코드와 schema 를 스펙과 항목별로 비교합니다.
- 수정 후 구현 또는 스펙을 함께 갱신하고 계약 검사를 다시 돌립니다.
실무 입력/출력 예시
입력
spec: POST /orders -> 201 actual: POST /orders -> 200
출력
contract mismatch 발견 조치: 서비스 구현 또는 스펙 응답 상태 코드 정렬