Framework/Spring Boot

Swagger 오류: Unable to infer base url. ...

반응형

새로 진행하는 프로젝트에서 swagger 설정을 해보았는데 아래와 같은 오류가 발생했다. 설정 오류라 얼럿으로 팝업이 출력되면서 swagger-ui.html화면으로 연결이 안 되는 현상.

Unable to infer base url. This is common when using dynamic servlet registration or when the API
is behind an API Gateway. The base url is the root of where all the swagger resources are served.
... (후략)

@EnableSwagger2 어노테이션을 Config클래스에 달아라, 메인클래스에 달아라, 버전을 2.9.2로 낮춰라, 스프링 시큐리티와 설정 충돌 문제다 등등 여러가지 답변이 많이 나왔는데 내 경우엔 디펜던시를 바꿔주니까 해결이 되었다.

//(kotlin dependency 입니다.)

//작동 안된 디펜던시
implementation("io.springfox:springfox-swagger2:3.0.0")
implementation("io.springfox:springfox-swagger-ui:3.0.0")

//정상 작동하는 디펜던시
implementation("io.springfox:springfox-boot-starter:3.0.0")
implementation("io.springfox:springfox-swagger-ui:3.0.0")

//3.0.0 버전에서는 /swagger-ui/index.html로 접속해야 정상적으로 페이지가 출력된다.

swagger2 깃허브 페이지에서도 springfox-swagger2 대신 springfox-boot-starter 디펜던시를 주입하라고 나와 있다. 온라인에 있는 많은 튜토리얼 포스팅에서 springfox-swagger2 디펜던시를 사용하고 있는데, 내 세팅에 안 맞는 것인지 전체적으로 리뉴얼을 해야 하는 것인지는 잘 모르겠다. 

 

springfox/springfox

Automated JSON API documentation for API's built with Spring - springfox/springfox

github.com

 

728x90
반응형