테스트하기 어려운 이유는 객체가 하나이기 때문만이 아니라, 호출 코드가 실제 저장소를 직접 선택하기 때문입니다. 저장소의 역할을 프로토콜로 표현하고 호출자가 구현을 주입하면 네트워크 없이 서비스의 판단을 확인할 수 있습니다.
핵심 원리와 선택 기준
인스턴스를 밖에서 받는 것과 다른 구현으로 교체할 수 있는 것은 구분해야 합니다. 구체 Database 타입만 받으면 대역도 그 타입 제약을 만족해야 합니다. 여기서는 OrderStore라는 작은 계약을 두고 서비스가 any OrderStore를 받게 합니다. 싱글톤 인스턴스도 이 계약을 만족하면 주입할 수 있습니다. 공식 근거
재현 코드
독립 예제에는 주문, 오류, 프로토콜, 서비스, 기록용 저장소를 모두 정의했습니다. 정상 주문의 전달값을 비교하고, 빈 ID는 저장 전에 거절하며, 저장소가 실패하면 호출자까지 같은 오류가 전달되는지 확인합니다. 기록용 저장소는 호출을 기록하는 spy와 실패를 설정하는 stub 역할을 겸합니다.
아래 코드는 2026-10-23에 Apple Swift 6.4, arm64 macOS 대상에서 Swift 6 언어 모드로 실행했습니다. 네트워크나 별도 패키지가 필요 없는 독립 실습입니다.
파일을 내려받은 폴더에서 실행하세요. 출력은 검증 결과이며, 실행 중 조건이 어긋나면 precondition에서 중단됩니다. -Ounchecked 옵션은 검증을 제거하므로 사용하지 마세요.
swift -swift-version 6 singleton-testing-dependency-injection.swift
struct Order: Equatable { let id: String }
enum SaveError: Error { case invalidID, unavailable }
protocol OrderStore {
func insert(_ order: Order) throws
}
struct OrderService {
let store: any OrderStore
func save(_ order: Order) throws {
guard !order.id.isEmpty else { throw SaveError.invalidID }
try store.insert(order)
}
}
final class RecordingStore: OrderStore {
var calls: [Order] = []
var shouldFail = false
func insert(_ order: Order) throws {
calls.append(order)
if shouldFail { throw SaveError.unavailable }
}
}
let store = RecordingStore()
let service = OrderService(store: store)
let order = Order(id: "order-42")
try service.save(order)
precondition(store.calls == [order])
do {
try service.save(Order(id: ""))
preconditionFailure("invalid input was accepted")
} catch SaveError.invalidID {}
precondition(store.calls.count == 1)
store.shouldFail = true
do {
try service.save(order)
preconditionFailure("storage failure was swallowed")
} catch SaveError.unavailable {}
precondition(store.calls.count == 2)
print("saved=order-42 invalid-input-writes=0 storage-error=propagated")
실행 결과와 해석
saved=order-42 invalid-input-writes=0 storage-error=propagated
정상 주문은 order-42로 저장 요청되었습니다. 빈 ID는 저장 호출을 추가하지 않았고, 저장 실패는 삼켜지지 않았습니다. 이 테스트는 단순히 호출 횟수만 보는 대신 전달된 주문 값과 두 실패 경로를 함께 검증합니다.
적용 범위와 주의점
프로토콜을 썼다고 실제 DB의 트랜잭션·유일성·네트워크 오류가 검증되는 것은 아닙니다. 별도의 저장소 통합 테스트가 필요합니다. 모든 의존성을 무조건 추상화할 필요도 없고, 전역 공유 상태를 주입만 했다고 격리 문제가 사라지는 것도 아닙니다.
다음으로 확인할 것
외부 I/O 경계 한 곳부터 작은 계약을 만드세요. 프로덕션 저장소와 테스트 대역이 같은 의미로 오류를 처리하는지 확인하고, 실제 연결은 앱을 조립하는 곳에서 선택합니다. 기존 동작을 바꾸는 경우에는 레거시 테스트 실습처럼 정책 변경을 분리하세요.
출처 및 확인 기준
- Inversion of Control Containers and the Dependency Injection PatternMartin Fowler · 저자 원문 · 확인 2026년 10월 23일근거: 구현 계약과 아래 설명의 근거. 실행 출력은 이 글에 포함된 별도 실험으로 확인했습니다.

