분산 Rust 환경의 일관된 장애 복구와 운영 효율을 위한 Metadata-centric 에러 설계

Context

기존 Rust 에러 핸들링 라이브러리들이 개별 도메인이나 CLI 진단에는 최적화되었으나, 분산 서비스 경계 간의 일관된 실패 계약(Failure Contract) 정의에는 한계 존재. 특히 외부 클라이언트용 응답과 내부 운영자용 진단 정보의 분리 및 WASM 환경의 메모리 효율성 확보가 시급한 과제였음.

Technical Solution

• 에러를 단순 값(Value)이 아닌 구조화된 Metadata Carrier로 정의하여 런타임 모델과 API 계약을 일원화한 설계
• nx-error-macros를 통한 도메인 시맨틱(Status, Code, Message)의 단일 정의 및 계층 간 자동 전파 구조 구축
• 외부 노출용 Stable Code와 내부 운영용 Full Source Chain을 분리하여 보안성과 진단 가능성을 동시에 확보
• WASM 컴포넌트 경계 내 Error Payload 크기 최적화를 통해 Enum Variant의 메모리 Bloat 방지
• with_message, with_help 메서드를 활용하여 런타임 시점에 컨텍스트를 동적으로 추가하는 유연한 전파 메커니즘 도입