클라우드 Mac에서 iOS AsyncStream 버퍼와 종료 계약 테스트하기
iOS 화면에서 AsyncStream으로 진행률 이벤트를 받고 있는데, 가끔 실행할 때는 정상적으로 동작하다가 연속으로 실행하면 중간 상태가 누락됩니다. 화면을 나간 뒤에도 하위 리스너가 계속 동작하기도 합니다. 이럴 때는 대기 시간부터 늘리지 마세요. VPSPull 클라우드 Mac에서 이벤트 생산과 소비 순서를 고정하고 버퍼링, 종료, 정리 계약을 각각 검증하면, 원격 데스크톱에서 반복해서 클릭하는 것보다 문제를 더 쉽게 좁힐 수 있습니다.
먼저 어떤 이벤트를 버려도 되는지 정하기
진행률은 대개 최신 상태만 있으면 되지만, 결제 확인이나 파일 전달 기록은 함부로 누락되어서는 안 됩니다. 먼저 스트림에 세 가지 조건을 명시하세요. 반드시 전달해야 하는 값은 무엇인지, 이벤트가 쌓이면 어떻게 처리할지, 생산자를 멈출 책임은 누구에게 있는지 정해야 합니다. 기본 버퍼링 정책이 비즈니스 요구사항을 대신 결정하게 두지 마세요.
unbounded는 아직 소비하지 않은 요소를 보관하지만, 생산이 계속되면 메모리 사용량이 끝없이 늘어날 수 있습니다. bufferingNewest(2)는 최신 요소 두 개를 유지하고, bufferingOldest(2)는 소비 대기 중인 가장 오래된 요소 두 개를 유지합니다. 여기서 용량은 바이트 수가 아니라 요소 개수입니다. 따라서 큰 객체는 여전히 많은 메모리를 차지할 수 있습니다.
버퍼 크기를 제한한다고 해서 백프레셔가 생기는 것은 아닙니다. AsyncStream의 yield는 소비자가 공간을 비울 때까지 기다리지 않습니다. 손실 없는 전달이 필요하다면 별도의 확인 응답, 속도 제한 또는 영속화 메커니즘을 마련해야 합니다.
처음에는 소비자를 하나만 두고 테스트하세요. 여러 작업이 같은 스트림을 함께 소비한다고 해서 “모든 구독자가 모든 이벤트를 받는” 브로드캐스트 모델이 되는 것은 아닙니다.
스케줄링 운에 의존하지 않는 테스트 픽스처 만들기
Swift 툴체인이 준비된 터미널에서 다음을 실행하세요.
mkdir StreamContract
cd StreamContract
swift package init --type library --name StreamContract
swift --version
생성된 테스트 파일의 내용을 아래 XCTest 테스트로 바꾸세요. 파일 경로는 Tests/StreamContractTests/StreamContractTests.swift입니다. 생성된 템플릿에 다른 테스트 파일이 있다면 먼저 예제 테스트를 제거해, 관련 없는 결과가 보고서에 섞이지 않도록 하세요.
import XCTest
final class StreamContractTests: XCTestCase {
func testNewestBufferDrainsAfterFinish() async {
let pair = AsyncStream<Int>.makeStream(
bufferingPolicy: .bufferingNewest(2)
)
pair.continuation.yield(1)
pair.continuation.yield(2)
switch pair.continuation.yield(3) {
case .dropped(let value):
XCTAssertEqual(value, 1)
default:
XCTFail("Expected the oldest buffered value to be dropped")
}
pair.continuation.finish()
var iterator = pair.stream.makeAsyncIterator()
let first = await iterator.next()
let second = await iterator.next()
let end = await iterator.next()
XCTAssertEqual(first, 2)
XCTAssertEqual(second, 3)
XCTAssertNil(end)
switch pair.continuation.yield(4) {
case .terminated:
break
default:
XCTFail("Expected a terminated stream")
}
}
}
이어서 swift test를 실행하세요. 이 테스트는 먼저 값을 생산한 다음 소비하므로 버퍼가 넘치는 상황을 명시적으로 만들며, sleep으로 스케줄링 순서를 추측할 필요가 없습니다. 툴체인에 makeStream이 없다면 먼저 Swift 버전을 확인하거나 초기화 클로저에서 continuation을 얻는 방식으로 바꾸세요. “호환성”을 이유로 버퍼 초과에 대한 검증을 삭제해서는 안 됩니다.
소비 결과뿐 아니라 버려진 값도 검증하기
최종적으로 2, 3을 받았다는 검증만으로는 부족합니다. 잘못된 구현이 1을 자체적으로 걸러 내도 우연히 같은 결과가 나올 수 있습니다. yield의 .dropped 반환값을 확인해야 값이 버퍼링 정책 계층에서 누락되었다는 사실을 검증할 수 있습니다.
다음으로 테스트를 복사해 bufferingOldest(2)로 바꾸세요. 세 번째 yield는 3이 버려졌다고 보고해야 하고, 소비 결과는 1, 2여야 합니다. 이 기대 동작을 각각 별도의 테스트 이름으로 명시하세요. 테스트 내부에서 실제 출력에 맞춰 정답을 바꾸면 안 됩니다.
경계 조건도 하나 추가해야 합니다. 용량이 0이고 대기 중인 소비자가 없을 때는 yield로 전달한 요소가 버려집니다. 용량 0은 동기적인 값 전달을 보장하지 않습니다. 소비자를 미리 시작하는 테스트라면 “이미 대기 중”임을 확인하는 동기화 신호가 반드시 있어야 합니다. 그렇지 않으면 작업 스케줄링에 따라 결과가 달라집니다.
실제 객체를 다룰 때는 안정적으로 식별할 수 있는 이벤트 ID만 기록하면 됩니다. 전체 페이로드를 로그에 쓰지 마세요. 데이터가 크다면 ID, 버려진 횟수, 버퍼링 정책만 기록해도 분석에 충분합니다.
finish, 취소, 조기 이탈을 따로 테스트하기
finish()는 더 이상 새 요소를 받지 않는다는 뜻이지, 이미 버퍼에 있는 요소를 즉시 버린다는 뜻이 아닙니다. 위 테스트는 의도적으로 2, 3을 모두 읽은 뒤 next가 nil을 반환하는지 검증합니다. 종료 후의 yield는 .terminated를 반환해야 합니다.
취소 테스트에는 별도의 픽스처를 만드세요. 소비 작업이 next를 기다리게 한 다음 그 작업을 취소하고, 작업이 끝날 때까지 기다립니다. 스레드 안전한 카운터나 테스트 기댓값으로 onTermination을 기록해 종료 원인이 취소인지 확인하고, 하위 리스너도 멈췄는지 확인하세요. 제한된 타임아웃은 테스트가 무한히 대기하는 상황을 막기 위한 장치일 뿐, 비즈니스 동작의 정확성을 입증하는 근거는 아닙니다.
조기 이탈에는 명시적인 소유자가 필요하다
루프 안의 break는 루프에서 빠져나올 뿐입니다. 다른 객체가 스트림이나 continuation을 계속 보유하고 있다면, 이것만으로 리스너가 해제되었다고 판단할 수 없습니다. 어댑터에 명시적인 stop을 제공하고 화면이나 서비스 소유자가 호출하게 한 뒤, 등록 해제 횟수를 확인하세요.
onTermination은 동시 실행 컨텍스트에서 호출될 수 있습니다. 정리 클로저가 캡처한 상태는 동시 접근을 안전하게 처리할 수 있어야 합니다. 메인 스레드에서만 접근할 수 있는 UI 객체를 직접 변경하지 마세요. 또한 내부 락을 잡은 채 finish를 호출하고 종료 콜백에서 같은 락을 다시 획득하도록 만들어서는 안 됩니다.
대기 시간을 늘리는 대신 실패 매트릭스로 마무리하기
최종 검증에는 최소한 네 가지 유형을 남겨 두세요. 최신 값 유지 버퍼가 오래된 값을 밀어내는지, 오래된 값 유지 버퍼가 새 값을 거부하는지, 정상 종료 시 버퍼를 모두 비우는지, 취소 후 생산이 멈추는지 확인해야 합니다. 각 유형에서 값, 종료 상태, 정리 횟수를 모두 검사해 “테스트는 통과했지만 리소스는 여전히 동작하는” 상황을 방지하세요.
이어서 가짜 리스너로 중지 시점의 경합 조건을 만드세요. stop 이후에도 콜백을 한 번 더 실행했을 때, 어댑터는 이를 안전하게 무시하거나 terminated를 받아야 하며 비즈니스 이벤트를 중복 전달해서는 안 됩니다. stop을 연속으로 호출해도 멱등성을 유지해야 하고, 같은 리스너 핸들을 중복으로 등록 해제해서는 안 됩니다.
제출할 때는 툴체인 버전, 테스트 명령, 실패한 테스트 케이스 이름을 함께 기록하세요. 순서를 고정한 테스트는 안정적인데 실제 화면에서 여전히 이벤트가 누락된다면, 다음으로 이벤트 소스 어댑터와 소비자의 처리 속도를 점검하세요. 픽스처 자체가 불안정하다면 먼저 동기화 방식을 고쳐야 합니다. sleep을 더 길게 넣어 경합 조건을 숨기지 마세요.
자주 묻는 질문
bufferingNewest는 생산자가 기다리게 하나요?
아닙니다. 버퍼가 가득 차면 이전 값을 버리고 yield가 해당 값을 알려 줄 뿐 소비자를 기다리지 않습니다. 크기가 제한된 무손실 전달에는 별도의 확인이나 흐름 제어가 필요합니다.
반복문에서 break하면 리스너가 바로 해제되나요?
항상 그렇지는 않습니다. 스트림과 continuation이 계속 유지될 수 있습니다. 소유자가 명시적으로 중지하도록 만들고 취소, 직접 중지, 정상 종료 경로를 각각 검증해야 합니다.
전용 Mac 한 대로 워크플로를 검증해 보세요
먼저 모델, 노드 위치, 대여 기간을 확인한 다음 하루 단위로 테스트해 보세요. 실제 이용 가능 여부는 콘솔에서 실시간으로 확인할 수 있습니다.