하드코딩과 os.getenv()를 대체하는 Pydantic 기반 설정 관리

Context

환경 변수를 하드코딩하거나 os.getenv()를 산발적으로 사용하는 구조. 설정 값의 타입 불일치로 인한 런타임 오류 가능성 상존. 체계적인 설정 관리 부재로 인한 유지보수 비용 증가.

Technical Solution

• pydantic-settings 라이브러리를 활용한 중앙 집중형 설정 클래스 설계
• BaseSettings 상속을 통한 환경 변수 자동 매핑 및 타입 검증 체계 구축
• 기본값 설정을 통한 로컬 개발 환경의 즉각적인 실행 가능 구조 확보
• .env 파일 로드 및 UTF-8 인코딩 설정을 통한 외부 환경 설정 분리
• case_sensitive 옵션을 통한 환경 변수 명칭의 엄격한 일치 검증
• extra = "ignore" 설정을 통해 정의되지 않은 환경 변수 유입 시 예외 처리 방지

Key Takeaway

애플리케이션 설정의 타입 안정성을 확보하여 런타임 오류를 컴파일 단계나 초기 구동 단계로 전이시키는 Shift-Left 전략의 구현.