[실습] Spring Cloud Gateway 셋팅하기 / 라우팅 설정하기

JSCODE 박재성

2025-12-06

✅ Spring Cloud Gateway 서버 기본 셋팅하기 / 라우팅 설정하기

1. Spring Boot 프로젝트 셋팅
start.spring.io
https://start.spring.io/



• Artifact와 Name을 api-gateway-service라고 지어주자.
• Package name을 Java 컨벤션에 맞게 apigatewayservice라고 지어주자.
• Java 21 버전을 선택하자. 아래 과정을 Java 21 버전을 기준으로 진행할 예정이다.
• Dependencies는 Spring Boot DevTools, Reactive Gateway를 선택하자.
 

2. application.yml 작성하기

이 프로젝트에서는 application.properties를 지우고 application.yml을 생성했다.

server:
  port: 8000

spring:
  cloud:
    gateway:
		  server:
			  webflux:
		      routes:
			      # /users로 시작하는 모든 경로의 요청은 user-service(localhost:8080)으로 전달
		        - id: user-service
		          uri: http://localhost:8080
		          predicates:
		            - Path=/users/**
		        # /boards로 시작하는 모든 경로의 요청은 board-service(localhost:8081)으로 전달
		        - id: board-service
		          uri: http://localhost:8081
		          predicates:
		            - Path=/boards/**
		        # /points로 시작하는 모든 경로의 요청은 point-service(localhost:8082)으로 전달
		        - id: point-service
		          uri: http://localhost:8082
		          predicates:
		            - Path=/points/**

• id : 각 라우팅 식별자
• uri : 클라이언트로부터 받은 요청을 전달할 주소
• predicates : 어떤 요청에 대해 특정 서비스로 요청을 전달할 지 패턴을 지정
 

3. 요청이 잘 라우팅되는 지 테스트해보기
1. 게시글 서비스의 게시글 조회 API 테스트



 
2. 사용자 서비스의 회원가입 API 테스트



 
3. 포인트 서비스의 포인트 차감 API 테스트
 
위 API 들을 실행시켰을 때 성공적으로 응답하는 걸로 봐서, API Gateway가 클라이언트의 요청을 각 마이크로서비스로 잘 전달해준다는 걸 알 수 있다.