Springfox UI文档访问引发HTTP 405错误

Question

我正在开发一个基于SpringBoot的REST Api，并使用Springfox生成swagger文档。

下面是大摇大摆的配置：

@Configuration
@EnableSwagger2
public class SwaggerConfiguration {
    @Autowired
    private AppConfiguration appConfiguration;

    @Bean
    public Docket api() {
        return new Docket(DocumentationType.SWAGGER_2)
                .groupName("app-api")
                .apiInfo(apiInfo())
                .select()
                .paths(PathSelectors.any())
                .build();
    }

    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("App API")
                .termsOfServiceUrl(appConfiguration.getApiTosUrl())
                .version("1.0").build();
    }
}

下面是我正在使用的web安全配置：

@Override
    protected void configure(HttpSecurity http) throws Exception {
        http.cors().and().csrf().disable().authorizeRequests()
                .antMatchers("/no-auth/**").permitAll()
                .antMatchers("/v2/api-docs", "/swagger-resources/configuration/ui", "/swagger-resources", "/swagger-resources/configuration/security", "/swagger-ui.html", "/webjars/**").permitAll()
                .anyRequest().authenticated()
                .and()
                .addFilter(new JWTAuthenticationFilter(securityConfiguration, authenticationManager()))
                // this disables session creation on Spring Security
                .sessionManagement().sessionCreationPolicy(SessionCreationPolicy.STATELESS);
    }

    @Override
    public void configure(AuthenticationManagerBuilder auth) throws Exception {
        auth.userDetailsService(userDetailsService).passwordEncoder(bCryptPasswordEncoder);
    }

    @Bean
    CorsConfigurationSource corsConfigurationSource() {
        final UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource();
        source.registerCorsConfiguration("/**", new CorsConfiguration().applyPermitDefaultValues());
        return source;
    }

访问URL：HTTP：//localhost:8080/swagger-ui.html时会出现HTTP错误405：不支持GEThtml" target="_blank">请求。

你可以指导我如何解决这个问题。

编辑：我注意到swagger-ui.htm根本没有被映射！我正在使用springfox 2.8.0

2018-05-14 12:17:47.019信息1012---[restartedMain]S.w.s.m.m.a.RequestMappingHandlerMapping：将“{[/swagger-Resources]}”映射到公共org.SpringFramework.http.ResponseEntity>SpringFox.Documentation.Swagger.Web.APIResourceController.SwaggerResources（）2018-05-14 12:17:47.020信息1012--[restartedMain]S.w.s.m.m.a.RequestMappingHandlerMapping：将IngFramework.boot.autocigure.web.servlet.error.BasicErrorController.Error（javax.servlet.http.HttpServletRequest）

Answer 1

当我有一个请求映射/**时，我也有同样的情况。405的原因是Swagger请求由另一个RequestMapping处理。您可以在DispatcherServlet中为swagger URL更改它。我在https://github.com/pmoerenhout/springfox-boot-bug上做了一个很小的例子。

您可以使用这个Spring映射来排除Swagger UI模式：

@RequestMapping(value = { "/", "/{part:^(?!swagger-ui$).*}/**" })