Spring Cloud Gateway - Invalid host: lb://auth_service 에러 해결기

🔍 문제 상황

Spring Cloud 기반의 MSA 프로젝트에서 Spring Cloud Gateway를 이용해 인증 마이크로서비스(auth-service)로 라우팅을 구성하던 중, 다음과 같은 에러가 발생했다.

java.lang.IllegalStateException: Invalid host: lb://auth_service

처음에는 Eureka에 서비스가 제대로 등록되지 않았거나, Gateway에서 fetch-registry 설정이 잘못됐다고 생각했지만, 로그를 아무리 살펴봐도 모든 설정은 정상적으로 보였다.

 

---

⚙️ 관련 설정

✅ Gateway application.yml 예시

spring:
  application:
    name: gateway-service

  cloud:
    gateway:
      discovery:
        locator:
          enabled: true
      routes:
        - id: auth-service
          uri: lb://auth_service
          predicates:
            - Path=/auth/**

❗ 원인 분석

에러 메시지의 핵심은 바로 이 부분이다:

Invalid host: lb://auth_service

 

Spring Cloud Gateway는 uri: lb://서비스이름 형식으로 Eureka에 등록된 서비스와 통신한다. 여기서 중요한 사실은:

🔹 lb:// 뒤에 오는 서비스명은 Eureka에 등록된 spring.application.name과 정확히 일치해야 하며,
🔹 하이픈(-)은 허용되지만, 언더바(_)는 비표준이며 문제를 일으킨다.

---

📌 Eureka 명명 규칙 (RFC 참고)

• 호스트 이름 규칙은 RFC 952, RFC 1123에서 정의됨
• 호스트 이름에는 하이픈(-)은 허용, 언더바(_)는 허용되지 않음
• Eureka 및 Spring Cloud LoadBalancer는 이 규칙을 따름

---

✅ 해결 방법

서비스 이름에서 언더바(_)를 하이픈(-)으로 바꾸면 된다.

 

변경 전

spring:
  application:
    name: auth_service

# Gateway
uri: lb://auth_service

변경 후

spring:
  application:
    name: auth-service

# Gateway
uri: lb://auth-service

---

🔄 부가 조치 사항

• Eureka 대시보드 (http://localhost:8761)에서 실제 등록된 서비스 이름을 확인
• Gateway 컨테이너가 먼저 올라가고 auth-service가 늦게 등록된 경우, Gateway 재시작 필요
• 모든 서비스가 동일한 Docker 네트워크 (예: msa-net)에 연결되어 있어야 함

---

💬 마무리하며

이 문제는 단순한 네이밍 이슈이지만, 직접 겪지 않으면 쉽게 간과할 수 있다. 특히 auth_service처럼 언더바를 사용하는 것이 흔한 네이밍 습관이라면 더더욱 그렇다.

이번 경험을 통해:

✅ MSA 환경에서는 서비스 이름도 DNS 호환성을 고려해 작명해야 한다는 교훈을 얻었다.