TECH 으로 돌아가기
TECH HACKER NEWS 12분 읽기 57 READS

고아 규칙과 싸우지 않는 법: Rust의 제네릭 컨텍스트 매개변수

Rust로 코드를 오래 짜다 보면 거의 반드시 error[E0117]을 만난다. 흔한 상황은 이렇다. 직렬화 라이브러리가 제공하는 ToJson 트레이트와, uuid 같은 서드파티 타입 라이브러리를 함께 끌어다 쓰면서 uuid::Uuid를 JSON으로 바꾸려고 impl을 작성하는 순간이다. 컴파일러는 이를 거부한다. 트레이트도 내 것이 아니고 타입도 내 것이 아니기 때문이다. 이것이 널리 알려진 고아 규칙(Orphan Rule)이며, 많은 개발자가 여기서 컴파일러가 지나치게 경직됐다고 불평하거나 순순히 NewType 래퍼로 감싸는 길을 택한다.

규칙의 목적을 먼저 이해하기

고아 규칙의 논리는 의외로 단순하다. 어떤 타입이 어떤 트레이트를 구현하려면, 그 타입이나 트레이트 중 최소 하나는 내 크레이트 소유여야 한다는 것이다. 왜 이런 제약이 필요한지는 충돌 시나리오를 보면 분명해진다. 크레이트 A가 uuid::Uuid에 대해 하이픈이 들어간 UUID 문자열을 내놓는 ToJson을 구현하고, 크레이트 B는 같은 타입에 대해 하이픈 없는 32자리 16진수를 내놓는 ToJson을 구현했다고 하자. 두 크레이트를 동시에 의존하는 프로젝트에서 컴파일러가 uuid.to_json()을 만나면 어느 구현을 골라야 할지 알 수 없다. Rust는 이런 전역 충돌을 막기 위해 일관성(coherence)을 강제하며, 고아 규칙이 그 수단이다. 규칙 자체는 의존성 트리가 커져도 생태계가 엉키지 않게 해주는 건전한 장치다.

문제는 현실의 프로젝트가 '남의 타입에 남의 트레이트를 구현하고 싶다'는 요구를 끊임없이 마주친다는 점이다. 타입도 트레이트도 내 것이 아니지만 라이브러리를 접착하는 이런 작업은 늘 일어난다. 현재 Rust 생태계가 쓰는 우회책은 대체로 두 가지인데, 둘 다 표면만 해결할 뿐 근본 원인을 건드리지 않아 금세 불편해진다. 첫째는 라이브러리가 ToJson을 내부에 정의해 두고 외부 타입에 대한 구현을 직접 제공하는 방식이다. 많은 기반 크레이트가 이 길을 택하는데, Cargo.toml을 열어 보면 with-uuid, with-chrono, with-time, with-jiff, with-url, with-rust-decimal 같은 피처 플래그가 길게 나열된 걸 볼 수 있다. 끝없이 변하는 생태계를 한 크레이트 안에 열거하려는 시도라 한계가 뚜렷하다. 둘째는 익숙한 NewType 패턴이지만, Uuid·Url·DateTime·HashMap에 커스텀 타입까지 뒤섞인 도메인 모델을 전부 감싸기 시작하면 비즈니스 로직이 .0으로 도배되고 값을 끊임없이 싸고 풀어야 한다. NewType은 도메인 의미를 표현하거나 불변식을 강제할 때는 훌륭한 패턴이지만, 오로지 고아 규칙을 달래려고 쓰면 코드가 빠르게 비대해진다.

규칙이 열어 둔 넓은 문

해법은 규칙의 정의로 되돌아가는 데 있다. 많은 개발자가 컴파일러는 impl Trait for Type에서 Trait와 Type만 본다고 생각하지만, RFC 2451에 따르면 트레이트의 제네릭 타입 매개변수도 검사 대상이다. 즉 impl Trait for Type에서 로컬 타입이 트레이트의 제네릭 매개변수 자리에 등장하고, 그 앞에 커버되지 않은 타입 매개변수가 없다면, 컴파일러는 이 구현이 오직 현재 크레이트에만 속한다고 판단한다. 다른 크레이트가 충돌하는 구현을 쓸 수 없으니 전역 일관성은 안전하고, 컴파일은 통과한다. ToJson이 외래 트레이트이고 Uuid가 외래 타입이어도, 내 크레이트에 정의한 MyCtx가 제네릭 자리에 있으면 그만이다.

라이브러리 작성자가 할 일은 한 걸음뿐이다. 트레이트에 사용자 확장용 제네릭 매개변수를 남겨 두되 Ctx = ()처럼 기본 타입을 주는 것이다. i32나 String 같은 기본 타입 구현을 임의의 Ctx에 대해 제네릭하게 작성해 두면, 일반 사용자는 Ctx의 존재조차 모른 채 예전과 똑같이 ()를 기본 컨텍스트로 쓴다. 서드파티 타입을 끼워 넣어야 할 때만 자기 크레이트에 빈 마커 구조체 MyCtx를 정의하고, 원하는 외래 타입들에 대한 구현을 붙이면 된다. 저자는 이 구조를 포도송이에 비유한다. 로컬 타입 MyCtx가 줄기이고 Uuid·Url·DateTime·HashMap 같은 서드파티 타입이 알맹이로 매달린다. 줄기를 쥐면 송이 전체가 한 번에 들려 올라가고, 컴파일러는 그 전부를 로컬 구현으로 받아들인다. 한 프로젝트에서 줄기를 여럿 둘 수도 있어서, HTTP API 계층은 ApiCtx로 타임스탬프를 문자열로, 내부 RPC 계층은 RpcCtx로 정수 타임스탬프로 포맷하는 식으로 컴파일 타임에 완전히 격리된다. 다만 로컬 타입은 진짜 새로 정의한 타입이어야 하며, 외래 타입에 대한 타입 별칭(alias)으로는 성립하지 않는다.

순서라는 함정

로컬 MyCtx를 아무 제네릭 자리에나 끼우면 끝이라고 생각하기 쉽지만, 트레이트에 제네릭 매개변수가 여럿이거나 제네릭 impl을 쓸 때는 순서 제약에 걸리기 쉽다. 컴파일러는 고아 규칙 검사 시 Self 타입, 트레이트의 첫 번째 제네릭 매개변수, 두 번째 순으로 고정된 순서로 훑는다. 핵심은 한 문장이다. 첫 로컬 타입보다 앞에 벌거벗은(bare) 제네릭 매개변수 T가 와서는 안 된다. 여기서 '벌거벗은'은 커버되지 않은 타입 매개변수를 뜻한다. 그냥 T는 커버되지 않았지만, Vec처럼 fundamental이 아닌 구체 타입으로 감싸이면 더 이상 벌거벗은 상태가 아니므로 뒤에 오는 로컬 MyCtx를 막지 않는다. 참고로 &T와 Box 같은 내장 fundamental 타입은 감싸는 것으로 치지 않는다. 라이브러리 저자 입장에서 교훈은 명확하다. 제네릭 슬롯을 추가하는 것만으로는 부족하고 위치도 맞아야 한다. 특별한 이유가 없다면 컨텍스트 Ctx를 첫 번째 타입 매개변수 자리에 두는 편이 하류 사용자가 제네릭 구현을 쓸 때 당황스러운 고아 규칙 오류를 피하게 해준다.

이 메커니즘이 손에 익으면 대규모 코드베이스의 고질적인 구조 문제도 풀린다. 프로젝트가 커지면 보통 Cargo 워크스페이스로 쪼개지고, 여러 모듈이 공유하는 구조체를 독립된 models 크레이트로 빼게 된다. 전통적으로 이 작업은 고통스러웠다. models가 Uuid·Url·DateTime 필드를 가진 Product를 정의하는데 직렬화 라이브러리나 ORM이 그 필드 타입들이 models 안에서 이미 트레이트를 구현하길 요구하면, 선택지가 둘 다 나쁘기 때문이다. 제네릭 Ctx 매개변수는 이 매듭을 푼다. models 안에서는 네이티브 타입으로 구조체를 정의하고, 임의의 Ctx에 열린 제네릭 구현을 Product에 작성하거나 derive 매크로가 생성하게 둔다. 흥미로운 지점은 models 안에서 Uuid와 DateTime이 아직 ToJson을 구현하지 않았는데도 이 코드가 컴파일된다는 것이다. models는 '나중에 쓰는 쪽의 컨텍스트 Ctx가 Uuid와 DateTime을 다룰 줄 안다면 Product는 그 컨텍스트에서 자동으로 ToJson을 지원한다'는 지연된 계약만 선언하기 때문이다. 덕분에 models는 구체적 변환 로직을 지니지 않아 가볍고 빠르게 컴파일되며, 실제 변환은 각자 로컬 컨텍스트를 붙이는 하류 서비스 크레이트로 미뤄진다.

실제 ORM에서의 검증

저자는 자신이 만든 Rust ORM인 Kova 전반에 이 패턴을 적용했다. ORM은 한 테이블에 Uuid·Url·DateTime·HashMap과 커스텀 도메인 타입이 뒤섞여 고아 규칙이 가장 아픈 영역이다. Kova의 핵심 Encode·Decode 트레이트는 바로 이 제네릭 슬롯 설계를 쓴다. 확장점을 사용자에게 넘긴 덕에 Kova는 정수·실수·불리언·문자열·바이트 배열 같은 DB 기본형만 내장 지원하면 되고, uuid·chrono·jiff·url을 위한 선택적 의존성과 피처 플래그 더미를 Cargo.toml에 유지할 필요가 없다. 실제 흐름은 앞선 예시 그대로다. 독립 models 크레이트에서 네이티브 타입으로 테이블 구조체를 정의하고 #[derive(Model)]을 붙이면 impl Model for Product where ... 같은 열린 계약으로 전개되어 models는 어떤 구체 코덱 구현에도 묶이지 않고 독립 컴파일된다. 하류 서비스 크레이트에서는 로컬 마커 pub struct AppCodec;를 정의해 저장 레이아웃에 맞는 제로카피 변환을 구현하고, 필요할 때 클라이언트의 컨텍스트 마커만 바꾼다. 이 전환은 런타임 비용이 없으며, 내부적으로는 Client의 PhantomData 마커를 ()에서 AppCodec으로 교체할 뿐이다.

Kova를 만들며 또 하나의 이점이 드러났다. AppCodec 같은 로컬 타입이 생기면 인코딩·디코딩 외에 더 많은 것을 그 타입에 매달 수 있다. 예컨대 url::Url에 Encode를 구현했어도 Url 컬럼에 LIKE 쿼리를 못 돌리거나 &str와 직접 비교하지 못하면 그 타입은 여전히 쿼리에서 이류 시민처럼 느껴진다. 그래서 Kova는 CanString, CanMath, Compatible 같은 SQL 역량 트레이트와 타입 호환 규칙에도 동일한 제네릭 확장 슬롯을 둔다. 사용자가 자기 AppCodec 아래 짧은 선언 몇 줄을 더하면 서드파티 타입이 ORM의 DSL에 녹아들어 내장 타입과 다를 바 없이 동작한다. 실제 복잡한 프레임워크를 통과시키며 확인된 교훈은 분명하다. 고아 규칙은 괴롭히려고 있는 게 아니라 전역 구현 충돌을 막으려고 있다. '전역에서 유일한' 구현을 쟁취하려는 싸움을 멈추고 트레이트에 제네릭 슬롯을 남겨 유일성의 범위를 로컬 컨텍스트로 좁히는 순간, 규칙을 우회하는 데는 아무런 흑마법도 필요 없다. 관점의 전환 하나가 라이브러리 설계와 대규모 워크스페이스의 경계를 동시에 깔끔하게 만든다.

SOURCE · HACKER NEWS
원문 전체 보기 → https://edvong.com/bypass-orphan-rule/
SHARE
NEXT · CHOOSE

변화를 읽었다면,
내가 만들 수익 구조를 고릅니다.

정보를 더 모으는 데서 멈추지 않고, 광고·외주·판매·중개·구독 중 내 상황에 맞는 출발점을 정해보세요.

21가지 수익 구조 살펴보기 →
처리 중...