如果没有为模块配置 API 版本控制,则会高亮显示端点的 version 属性。

可以通过两种方式配置 API 版本控制:

例如:


  # 对于 Spring Boot 项目
  spring.mvc.apiversion.use.header=Api-Version
  spring.mvc.apiversion.default=1.0
  spring.mvc.apiversion.detect-supported=false

或:


  // Spring Boot 和 Spring Framework 项目均支持使用这种方式
  @Configuration
  public class MyWebConfig implements WebMvcConfigurer {

      @Override
      public void configureApiVersioning(ApiVersionConfigurer configurer) {
          configurer
                  .useRequestHeader("Api-Version")
                  .setDefaultVersion("1.0")
                  .detectSupportedVersions(false);
      }
  }