Skip to content

@ConfigurationProperties로 타입-안전한 설정 관리 도입#84

Merged
jihukimme merged 4 commits intodevelopfrom
feature/config-setup
Sep 11, 2025
Merged

@ConfigurationProperties로 타입-안전한 설정 관리 도입#84
jihukimme merged 4 commits intodevelopfrom
feature/config-setup

Conversation

@jihukimme
Copy link
Member

📝 작업 내용

  • 기존의 @Value나 하드코딩 방식은 오타에 취약하고, 설정값 누락 시 런타임 오류를 유발할 수 있는 타입 불안전성 문제가 있었음
  • 이를 해결하기 위해 @ConfigurationProperties를 사용하는 FastApiProperties` 클래스를 도입하여 FastAPI 연동 설정을 중앙화하고, 애플리케이션 시작 시점에 설정값의 타입과 유효성을 검증하도록 개선
  • 이를 통해 잠재적인 런타임 장애를 원천 차단하고, 코드의 안정성과 유지보수성 향상

🔗 관련 이슈

  • Closes #이슈번호
  • Related to #이슈번호

💬 추가 요청사항


✅ 체크리스트

코드 품질

  • 커밋 컨벤션 준수 (feat/fix/docs/refactor 등)
  • 불필요한 코드/주석 제거

테스트

  • 로컬 환경에서 동작 확인 완료
  • 기존 기능에 영향 없음 확인

배포 준비

  • 환경변수 추가/변경사항 문서화
  • DB 마이그레이션 필요 여부 확인
  • 배포 시 주의사항 없음

기존의 @value나 하드코딩 방식은 오타에 취약하고, 설정값 누락 시
런타임 오류를 유발할 수 있는 타입 불안전성 문제가 있었습니다.

이를 해결하기 위해 @ConfigurationProperties를 사용하는 `FastApiProperties`
클래스를 도입하여 FastAPI 연동 설정을 중앙화하고, 애플리케이션 시작 시점에
설정값의 타입과 유효성을 검증하도록 개선했습니다.

이를 통해 잠재적인 런타임 장애를 원천 차단하고, 코드의 안정성과
유지보수성을 크게 향상시켰습니다.
@jihukimme jihukimme self-assigned this Sep 11, 2025
@jihukimme jihukimme added the enhancement New feature or request label Sep 11, 2025
# Conflicts:
#	apps/user-service/src/main/java/site/icebang/common/health/service/FastApiClient.java
@jihukimme jihukimme merged commit 0f238ed into develop Sep 11, 2025
5 checks passed
@jihukimme jihukimme deleted the feature/config-setup branch September 11, 2025 07:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

Comments