Testing & Code Quality

싱글톤과 테스트: 저장소 주입으로 성공·실패를 검증하기

싱글톤 사용 자체보다 구현을 직접 고르는 결합이 테스트를 어렵게 만듭니다. 저장소 프로토콜과 기록용 대역을 만들고 정상 저장, 잘못된 입력, 저장 실패 전파를 실제로 검증합니다.

3분 읽기
싱글톤과 테스트: 저장소 주입으로 성공·실패를 검증하기 대표 이미지

테스트하기 어려운 이유는 객체가 하나이기 때문만이 아니라, 호출 코드가 실제 저장소를 직접 선택하기 때문입니다. 저장소의 역할을 프로토콜로 표현하고 호출자가 구현을 주입하면 네트워크 없이 서비스의 판단을 확인할 수 있습니다.

핵심 원리와 선택 기준

인스턴스를 밖에서 받는 것과 다른 구현으로 교체할 수 있는 것은 구분해야 합니다. 구체 Database 타입만 받으면 대역도 그 타입 제약을 만족해야 합니다. 여기서는 OrderStore라는 작은 계약을 두고 서비스가 any OrderStore를 받게 합니다. 싱글톤 인스턴스도 이 계약을 만족하면 주입할 수 있습니다. 공식 근거

재현 코드

독립 예제에는 주문, 오류, 프로토콜, 서비스, 기록용 저장소를 모두 정의했습니다. 정상 주문의 전달값을 비교하고, 빈 ID는 저장 전에 거절하며, 저장소가 실패하면 호출자까지 같은 오류가 전달되는지 확인합니다. 기록용 저장소는 호출을 기록하는 spy와 실패를 설정하는 stub 역할을 겸합니다.

아래 코드는 2026-10-23에 Apple Swift 6.4, arm64 macOS 대상에서 Swift 6 언어 모드로 실행했습니다. 네트워크나 별도 패키지가 필요 없는 독립 실습입니다.

전체 Swift 파일 내려받기

파일을 내려받은 폴더에서 실행하세요. 출력은 검증 결과이며, 실행 중 조건이 어긋나면 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 경계 한 곳부터 작은 계약을 만드세요. 프로덕션 저장소와 테스트 대역이 같은 의미로 오류를 처리하는지 확인하고, 실제 연결은 앱을 조립하는 곳에서 선택합니다. 기존 동작을 바꾸는 경우에는 레거시 테스트 실습처럼 정책 변경을 분리하세요.

연결해서 읽기

출처 및 확인 기준