호환성 파괴 변경

호환성 파괴 변경이란 기존 API, 설정, 동작 방식을 변경해 이전 사용 코드가 수정 없이는 정상 동작하지 않게 만드는 변경이다. 새 기능 추가와 달리 이 변경은 사용하는 쪽이 자기 코드를 능동적으로 고쳐야만 업그레이드가 가능하므로, 업그레이드 계획 전체의 비용과 일정을 좌우하는 핵심 변수가 된다. 흔한 오해는 버전이 올라갔다고 해서 항상 이런 변경이 포함된다고 단정하는 것과, 반대로 작은 수정이라 문서에 안 적혀 있으니 안전하다고 넘겨짚는 것이다. 실제로는 타입 시그니처 변경, 기본값 변경, 암묵적으로 의존하던 내부 동작의 수정처럼 겉보기에 사소한 변경도 특정 사용 패턴에서는 이런 변경으로 작용할 수 있다. 그래서 업그레이드 전에는 변경 이력을 읽는 것만으로는 부족하고, 실제 코드베이스에서 해당 기능을 어떻게 쓰고 있는지 점검하는 작업이 함께 필요하다.