Spring Cloud Config Client 설정 후 포트번호가 변경되지 않을 때

유튜브에서 “개발자 유미”님의 스프링 클라우드 MSA강의를 듣던 중 “Config 클라이언트 설정” 파트에서 생긴 이슈입니다.

📍 배경

Config 서버를 정상적으로 구축한 후, Config 클라이언트 설정을 완료한 뒤 클라이언트 엔드포인로 접속을 시도했지만 GitHub 리포지토리에 설정한 포트번호(8081)로 변경이 되지 않는 문제가 발생했다.

Config 서버(http://localhost:9000/jisutudy/dev)로 접속 → 성공

Config 클라이언트(http://localhost:8081/)로 접속 → 실패

• 기존에 연결되던 8080포트에서만 정상적으로 웹사이트 로딩
• 동일한 오류를 재현했으나, 같은 설정을 적용해도 새로운 오류가 발생하여 스크린샷을 확보하지 못함

📍 원인

Spring Cloud Version 호환 때문이었다…^^;

Spring Cloud 버전 호환 문제

Config 서버와 클라이언트 간의 버전이 맞지 않아 Config 서버와의 연결이 정상적으로 이루어지지 않았다.

• Gradle 의존성 확인:
  • IntelliJ의 Gradle 탭을 열어보니 여러 패키지에 빨간 줄이 표시됨 → 버전 불일치 가능성 높음
  • spring-cloud-starter-config의 버전이 현재 Spring Boot 버전과 호환되지 않음

프로젝트 구성 방식에 따른 영향

• Config Server는 새롭게 생성한 프로젝트였음
• Config Client는 기존 개인 프로젝트(스프링 부트 3.3.5 기반)에서 추가 설정을 적용했음
  • 기존 프로젝트의 Spring Boot 버전과 Spring Cloud 버전이 맞지 않아 정상적으로 동작하지 않음

📍 해결 방법

Spring Cloud Version 호환 문제

위 블로그 포스팅을 참고해서 버전을 변경해주었습니다

1. Spring Boot와 Spring Cloud 버전 호환 확인

• Spring Cloud 공식 문서에서 Spring Boot 버전에 맞는 Spring Cloud 버전을 확인

2. build.gradle에서 버전 명시

• Spring Boot 버전 확인
  • build.gradle의 plugins 섹션에서 현재 사용 중인 Spring Boot 버전을 확인

• Spring Cloud 버전 수정
  • Spring Cloud 공식문서에서 확인한대로 spring-cloud-starter-config 버전을 4.1.5로 명시하여 호환성을 맞춤
  • springCloudVersion 도 2023.0.5 로 명시하여 호환성을 맞춤

📍 배운 점

• 의존성 관리의 중요성:
  • 기존에는 build.gradle에서 버전을 직접 명시하지 않고 자동 버전 관리를 사용했으나 이번 경험을 통해 버전 충돌 문제를 해결하기 위해 시간을 많이 소비하게 되면서 개발 생산성에 미치는 영향 체감
  • 이후부터는 Gradle에 의존성을 추가할 때 Gradle 탭에서 버전이 충돌 되지 않는지 확인을 해보는 습관을 들이며 충돌이 난 경우 바로 의존성 버전을 명시하여 개발 생산성을 향상시킬 것