본문으로 건너뛰기
Previous
Next
Breaking Change 뜻과 의미 | 기술 용어 사전 | pkglog
일반

Breaking Change

다른 이름: 호환성 깨짐 , 브레이킹 체인지

정의

기존 API 사용자나 코드에 영향을 주어 호환성이 깨지는 변경 사항. 함수 시그니처 변경, API 응답 형식 변경, 환경 변수 추가/제거 등. Semantic Versioning에서 메이저 버전 업데이트. CHANGELOG와 마이그레이션 가이드 필수

상세 설명

💡 실무 활용

  • 함수 파라미터 타입 변경
  • API 엔드포인트 제거
  • 환경 변수 이름 변경
  • 데이터베이스 스키마 변경

장점

  • 기술 부채 정리 기회
  • 더 나은 설계로 전환

⚠️ 단점 및 제약

  • 기존 사용자 코드 수정 필요
  • 마이그레이션 비용
  • 버전 단절 위험