레거시 코드를 안전하게 바꾸려면 먼저 현재 결과를 고정하고, 구조 변경과 정책 변경을 분리해야 합니다. 테스트는 기존 동작을 관찰하는 도구이지 그 동작이 올바른 업무 규칙이라는 보증서는 아닙니다.
핵심 원리와 선택 기준
리팩터링은 관찰 가능한 동작을 유지하면서 내부 구조를 바꾸는 작업입니다. 규칙을 모르는 코드라면 정상 입력만 고르지 말고 조건문이 갈라지는 경계, 빈 값, 실패 경로를 먼저 기록합니다. 이 예제에서는 B 고객의 양수 금액에서 30을 차감하는 기존 함수를 대상으로 삼습니다. 공식 근거
재현 코드
재현용으로 만든 할인 함수를 조건식 기반 구현으로 바꾸고, -1·0·1·29·30·31·100과 다른 고객 유형을 포함한 9개 사례를 비교합니다. 예상값은 기존 함수 호출 결과를 다시 쓰지 않고 표에 따로 적었습니다. 그 덕분에 두 구현이 같은 실수를 하더라도 명시한 계약과 비교할 수 있습니다.
아래 코드는 2026-10-23에 Apple Swift 6.4, arm64 macOS 대상에서 Swift 6 언어 모드로 실행했습니다. 네트워크나 별도 패키지가 필요 없는 독립 실습입니다.
파일을 내려받은 폴더에서 실행하세요. 출력은 검증 결과이며, 실행 중 조건이 어긋나면 precondition에서 중단됩니다. -Ounchecked 옵션은 검증을 제거하므로 사용하지 마세요.
swift -swift-version 6 legacy-code-maintenance-problems.swift
func legacyPrice(kind: String, amount: Int) -> Int {
if kind == "B" && amount > 0 { return amount - 30 }
return amount
}
func refactoredPrice(kind: String, amount: Int) -> Int {
let discount = kind == "B" && amount > 0 ? 30 : 0
return amount - discount
}
let cases: [(String, Int, Int)] = [
("B", -1, -1), ("B", 0, 0), ("B", 1, -29),
("B", 29, -1), ("B", 30, 0), ("B", 31, 1),
("B", 100, 70), ("A", 100, 100), ("A", 0, 0)
]
var clampDifferences = 0
for (kind, amount, expected) in cases {
precondition(legacyPrice(kind: kind, amount: amount) == expected)
precondition(refactoredPrice(kind: kind, amount: amount) == expected)
let changed = kind == "B" && amount > 0 ? max(0, amount - 30) : amount
if changed != expected { clampDifferences += 1 }
}
precondition(clampDifferences == 2)
print("cases=9 preserved=9 clamp-differences=2")
실행 결과와 해석
cases=9 preserved=9 clamp-differences=2
두 구현은 9개 사례 모두 일치합니다. 그런데 음수를 0으로 보정하는 변경을 넣으면 금액 1과 29에서 기존 예상값과 달라집니다. clamp-differences=2는 테스트 실패를 숨긴 것이 아니라, 그 정책 변경이 기존 계약을 두 곳에서 바꾼다는 별도 검증입니다.
적용 범위와 주의점
음수 최종 금액을 허용해야 한다는 결론은 아닙니다. 실제 서비스의 할인 정책은 담당자와 확인해야 합니다. 여기서는 작은 정수만 사용했으며, 세금·통화 반올림·정수 오버플로·DB 부작용을 검증하지 않았습니다. 9개 사례만으로 모든 입력의 동등성도 증명할 수 없습니다.
다음으로 확인할 것
실제 코드에서는 먼저 호출부와 저장 데이터를 조사해 관찰값을 보강하세요. 음수를 금지해야 한다면 요구사항 변경으로 새 예상값을 합의한 다음 별도 변경으로 적용합니다. 외부 DB 때문에 테스트가 어렵다면 저장소 의존성을 분리하는 실습으로 이어가면 됩니다.
출처 및 확인 기준
- Definition of RefactoringMartin Fowler · 저자 원문 · 확인 2026년 10월 23일근거: 구현 계약과 아래 설명의 근거. 실행 출력은 이 글에 포함된 별도 실험으로 확인했습니다.

