[Swagger Error] Spring boot 3.0.x 이상 springdoc-openapi Swagger 화면이 로드되지 않을 때.

다음과 같이 swagger-ui에 접속은 되는데, 내용들이 불러와지지 않고 하얀 화면만 보이는 증상이 발생했다.

Spring Security 경로도 열어줬고, 설정도 다 했는데 왜 안될까 고민하며 F5만 누르다가

혹시 몰라 F12를 눌러 콘솔을 찾아봤다.

다음 사진을 보면 /swagger-ui/ 다음으로 하위 경로에 있는 .css, .js 파일들이 로드되지 못하고 있는 것을 알 수 있었다.

기존 Security Config에서 Swagger의 경로 지정을 아래와 같이 지정했었는데
private final String[] SWAGGER = {"/v3/api-docs", "/swagger-ui", "/swagger-ui/index.html"};

 

하위 경로까지 모두 허용하는 코드로 변경했다.
private final String[] SWAGGER = {"/v3/api-docs/**", "/swagger-ui/**"};

 

허용 후 깔끔하게 접속 되는 것을 볼 수 있다.

 

스프링부트 3.0.x 이상 swagger 설치

[Spring Boot] SpringBoot 3.0.x 이상에서 Swagger 사용