Tech
라이브 API 컨트랙트가 CI 파이프라인으로는 발견할 수 없는 방식으로만 깨지는 이유는 무엇인가?
81
기회
소비자 주도 계약 테스트는 병합 전에 브레이킹 체인지를 잡아내지만, PR 시점에 계약을 고정시키며 배포 이후 라이브 서비스에서 누적되는 의미적 드리프트를 감지할 방법이 없다. 팀은 프로덕션 핫픽스에서 미문서화 필드를 추가하거나, 장애를 해결하기 위해 오류 형태를 변경하거나, OpenAPI 스펙을 건드리지 않은 채 유효성 검사를 완화하기도 한다. World Quality Report 2025는 감지되지 않은 API 스키마 드리프트를 분산 시스템의 프로덕션 장애 3대 원인 중 하나로 지목하며, 프로덕션에서 발생하는 API 오류의 약 70%가 모든 CI 검사를 통과했다고 추정한다. 현재 어떤 도구도 실제 프로덕션 트래픽을 공개된 컨트랙트와 지속적으로 대조하여 병합 시점이 아닌 위반이 누적되는 시점에 이를 표면화하지 않는다.
왜 중요한가
실제 라이브 트래픽을 공개한 컨트랙트와 대조하면, API가 약속한 것과 조용히 제공하지 않게 된 것 사이의 마지막 격차를 해소할 수 있다.
기회 평가 방식
기회 점수는 측정값이 아닌 제 주관적 평가입니다. 얼마나 불편한지, 얼마나 자주 발생하는지, 현재 해결책이 얼마나 부족한지를 반영합니다. 점수가 높을수록 만들 가치가 더 높다고 생각합니다.
심각도8/10
발생했을 때 얼마나 큰 불편을 초래하는지.
빈도8/10
실제로 얼마나 자주 접하게 되는지.
공백 영역7/10
현재 이를 해결할 만한 도구가 얼마나 부족한지.