Swagger 적용 후, 화이트라벨 오류 ( Springboot 3.x 이슈 )

 

 

프로젝트에 OpenApi(Swagger)를 적용하고,

http://localhost:8080/swagger-ui/index.html 접속하니 화이트라벨 오류가 뜬다. 왜지?!!!!!😱

기존에 스웨거 잘 적용되어 있는 타 프로젝트 코드를 들고 왔는데, 왜 안되지

 

한참을 구글링하다가 이번 프로젝트는 스프링부트 3.x으로 설정 했다는게 생각났다

 

기존

dependencies {
    implementation 'org.springdoc:springdoc-openapi-ui:1.6.9'
}

 

import io.swagger.v3.oas.models.Components;
import io.swagger.v3.oas.models.OpenAPI;
import io.swagger.v3.oas.models.info.Info;
import io.swagger.v3.oas.models.security.SecurityRequirement;
import io.swagger.v3.oas.models.security.SecurityScheme;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

import java.util.Arrays;


@Configuration
public class SwaggerConfig {
    @Bean
    public OpenAPI openAPI() {
        Info info = new Info()
                .title("test api")
                .version("v1")
                .description("test api");
        SecurityScheme securityScheme = new SecurityScheme()
                .type(SecurityScheme.Type.APIKEY)
                .scheme("apiKey")
                .name("Authorization")
                .in(SecurityScheme.In.HEADER);
        SecurityRequirement securityRequirement = new SecurityRequirement().addList("Auth");
        return new OpenAPI().components(new Components().addSecuritySchemes("Auth", securityScheme))
                .info(info)
                .security(Arrays.asList(securityRequirement));
    }
}

 

 

변경

SwaggerConfig는 동일하고, dependencies를 변경해줬다

스프링부트 3.x 버전에서는 아래 종속성으로 사용하기!

dependencies {
    implementation 'org.springdoc:springdoc-openapi-starter-webmvc-ui:2.0.2'
}

 

 

 

 

 

참고사이트

https://velog.io/@kjgi73k/Springboot3%EC%97%90-Swagger3%EC%A0%81%EC%9A%A9%ED%95%98%EA%B8%B0

Springboot 3.x에 Swagger를 적용시켜보자!