当存在WebMvcConfigurationSupport时，不会生成Swagger UI

Question

我正在尝试在我的spring boot项目中生成Swagger UI。JSON API文档生成了，但是Swagger UI没有，至少我在输入swagger ui地址时得到了404。我的依赖项：

    <dependency>
        <groupId>io.springfox</groupId>
        <artifactId>springfox-boot-starter</artifactId>
        <version>3.0.0</version>
    </dependency>
    <dependency>
        <groupId>io.springfox</groupId>
        <artifactId>springfox-swagger-ui</artifactId>
        <version>3.0.0</version>
    </dependency>

但是，当我删除此配置时(不做任何其他操作)：

@Configuration
public class WebConfig extends WebMvcConfigurationSupport {

    @Override
    protected void addFormatters(FormatterRegistry registry) {
        registry.addConverter(new SomeEnumConverter());
        registry.addConverter(new AnotherEnumConverter());
    }
}

Swagger UI工作正常。Swagger UI在转换器方面有问题吗？有没有解决这个问题的办法？

Answer 1

您需要添加@EnableWebMvc注释

@EnableWebMvc
@Configuration
public class WebConfig extends WebMvcConfigurationSupport {

  @Override
  protected void addFormatters(FormatterRegistry registry) {
    registry.addConverter(new SomeEnumConverter());
    registry.addConverter(new AnotherEnumConverter());
  }
}

但我认为现在配置WebMvc的官方方式是实现WebMvcConfigurer。您可以在official docs中看到几个示例。我认为如果你使用Spring Boot，它不需要@EnableWebMvc。

@Configuration
public class WebConfig implements WebMvcConfigurer {

  @Override
  protected void addFormatters(FormatterRegistry registry) {
    registry.addConverter(new SomeEnumConverter());
    registry.addConverter(new AnotherEnumConverter());
  }
}