Roslyn 분석기와 파이프라인 캐싱을 통한 MediatR의 Black Box 문제 해결

Context

전통적인 Mediator 패턴 구현체가 런타임 시점에만 오류를 발견하는 Black Box 구조로 동작함에 따른 추적성 저하 발생. 요청 흐름의 불투명성과 리플렉션 기반의 오버헤드로 인한 성능 병목 지점이 주요 한계점으로 작용.

Technical Solution

• Roslyn Analyzer 도입을 통한 IRequest와 IRequestHandler 간의 미매칭 상태를 컴파일 단계에서 식별하는 정적 분석 체계 구축
• ValueTask 채택 및 Native AOT Trimming 호환 설계를 통한 Zero-allocation 경로 확보로 메모리 효율 극대화
• 리플렉션 의존도를 낮추기 위해 요청 타입별 실행 파이프라인을 사전 캐싱하는 구조를 통한 Hot Path 성능 최적화
• ActivitySource 기반의 Native OpenTelemetry 통합으로 분산 트레이싱을 위한 자동 Span 생성 메커니즘 구현
• 컴파일된 어셈블리 스캔 기반의 CLI 도구를 통해 실제 코드 기반의 Sequence Diagram을 자동 생성하는 Documentation as Code 실현
• Polly 통합 Behavior 설계를 통한 Circuit Breaker 및 Retry 로직의 선언적 적용 체계 마련