[Spring Boot] HTTPS(NginX) 배포 환경에서 Swagger 에러

 

 

NginX를 이용해 HTTPS 설정을 한 Spring Boot 배포 환경에서 Swagger 사용시 요청이 제대로 가지 않는 에러가 발생함

 

• Security 꺼져 있음
  
  
• EC2에 컨테이너로 spring boot가 돌아가는중임
  
  
• NginX에서 http, https 모두 요청 가능하게 설정해둠

 

Failed to fetch

 

 

 

우선 별다른 설정 추가 없이 기본 설정으로 Swagger를 사용중인데 Server를 살펴보면 http://172.17.0.2:8080 으로 되어있는걸 확인할 수 있음

 

이는 Spring boot 컨테이너의 Docker 내부 IP인데

 

Spring Boot에서 server.address를 별도로 작성하지 않으면, Swagger는 기본적으로 Spring Boot 어플리케이션이 바인딩된 주소를 Server URL로 사용함

 

172.17.0.2 와 같은 Docker 내부 IP는 Docker 네트워크 내부에서만 접근이 가능한데 브라우저(Swagger UI)는 Docker 컨테이너 외부 (호스트 머신)에서 실행됨

 

=> 브라우저에서 직접 Docker 내부 네트워크로 접근할 수 없음

 

그래서 가장 먼저 한 것은

 

@Configuration
class SwaggerConfig {

    @Bean
    fun openAPI(): OpenAPI = OpenAPI()
        .addServersItem(Server().url("http://vocalab.kro.kr").description("Production Server"))
        .addServersItem(Server().url("http://localhost:8080").description("Local Server"))
        .components(Components())
        .info(
            Info()
                .title("보이스팩 플랫폼 API")
                .description("보이스팩 플랫폼 API 문서")
                .version("v1.0.0")
        )
}

 

SwaggerConfig 파일에서 addServersItem을 통해 Server url을 명시해주었음

 

이 때 로컬 환경에서도 Swagger를 사용하기 위해 localhost:8080 도 추가하였음

 

Mixed Content

 

아무생각 없이 http://vocalab.kro.kr 을 Server에 추가했는데

Swagger에서 요청을 보내보면 403 Forbidden이 발생하는 것을 확인할 수 있음

 

이는 위에서 말했듯이 NginX로 HTTPS 설정이되어 있기 때문인데 swagger-ui에 접속할 때

https://vocalab.kro.kr/swagger-ui/index.html   즉, HTTPS 환경의 브라우저에 실행됨

 

따라서, Swagger에서 API 요청을 보낼 때 http://vocalab.kro.kr Server를 사용하게 되면

HTTPS 환경인 Swagger UI에서 HTTP 요청이 발생하므로 Mixed Content 문제가 발생하며 브라우저 보안 정책에 의해 차단됨

 

@Configuration
class SwaggerConfig {

    @Bean
    fun openAPI(): OpenAPI = OpenAPI()
        .addServersItem(Server().url("https://vocalab.kro.kr").description("Production Server"))
        .addServersItem(Server().url("http://localhost:8080").description("Local Server"))
        .components(Components())
        .info(
            Info()
                .title("보이스팩 플랫폼 API")
                .description("보이스팩 플랫폼 API 문서")
                .version("v1.0.0")
        )
}

 

따라서 위와 같이 https 서버 주소를 입력해줘야함

(http로 Swagger UI에 접속하는 방안도 있음)

 

 

403 Forbidden

 

그럼 이제 될까?!

하지만 여전히

 

Error: response status is 403

Response headers
 access-control-allow-headers: Authorization,Content-Type 
 access-control-allow-methods: GET,POST,PUT,DELETE,OPTIONS 
 access-control-allow-origin: * 
 connection: keep-alive 
 date: Tue,25 Mar 2025 14:48:18 GMT 
 server: nginx/1.24.0 (Ubuntu) 
 transfer-encoding: chunked 
 vary: Origin,Access-Control-Request-Method,Access-Control-Request-Headers

 

위와 같은 에러가 발생함

 

tail -f /var/log/nginx/access.log

 

EC2에 접속해서 위 명령어로 NginX의 access.log를 살펴보며 Swagger에서 요청을 보내보면 로그가 찍히는걸 확인할 수 있음
(NginX가 다른 프록시 EC2가 아니라 Server가 위치한 EC2 자체에 설치되어있는 상황임)

=> NginX까지 요청은 도달하는걸 확인

 

그럼 Spring Boot 서버쪽에서 막히는 것 같은데

 

현재까지 통신 흐름을 다시 정리해보면

 

1. 사용자가 https로 Swagger UI에 접속함

2. Swagger가 https://vocalab.kro.kr/api/... 로 API 요청을 보냄

3. NginX가 이 요청을 받아 내부 Spring Boot 컨테이너인 http://172.17.0.2:8080 로 전달함

 

4. Spring Boot 컨테이너가 이를 처리한 후, NginX가 다시 사용자에게 응답 전달

즉, Swagger UI는 외부에서 https://vocalab.kro.kr 로 요청을 보내는 구조이지만 

NginX가 내부적으로 http://172.17.0.2:8008 로 프록시하는 구조임

 

@Configuration
class WebConfig : WebMvcConfigurer{

    override fun addCorsMappings(registry: CorsRegistry) {
        registry.addMapping("/**") // 모든 경로에 대해 CORS 설정 (추후 변경)
            .allowedOrigins(
                "https://capstone-2025-09.vercel.app",
                "https://vocalab.kro.kr"
            )
            .allowedMethods("*")
            .allowedHeaders("*")
            .allowCredentials(true)
    }
}

 

이와 같이 WebConfig에서 allowedOrigins에 https://vocalab.kro.kr을 추가해주면서 해결하였음
(Security 미사용중)  

 

왜냐하면 Spring 입장에서는 요청의 Origin: https://vocalab.kro.kr 헤더를 보고 외부 요청이라고 판단함 

 

=> Spring 입장에선 Origin 헤더를 통해 이게 브라우저에서 온 외부 요청인지 아닌지를 판단하기 때문에 "같은 도메인인데 왜?" 라는 생각이 들더라도 결국 Spring이 허용하지 않으면 차단되는 원리임

 

 

 

 

요청이 잘 가는걸 확인할 수 있음