Swagger弹窗报错

  • Post author:
  • Post category:其他




前言

springboot集成swagger后,访问http://localhost:7000/swagger-ui.html#/ 出现弹窗报错:

在这里插入图片描述



问题排查



查看是否配置了拦截器,如果配置了,则放行swagger的相关请求

"/swagger-resources/**"
,"/webjars/**"
,"/v2/**"
,"/swagger-ui.html/**"



项目中使用了全局统一处理类即@ControllerAdvice/ResponseBodyAdvice导致

项目中如果使用了@ControllerAdvice/ResponseBodyAdvice 全局处理接口返回值的类,会导致接口返回 JSON数据格式和 swagger 期望的不一样,造成 swagger 报错!

刚好有使用到这个!

在这里插入图片描述


解决方式


打开@ControllerAdvice注解类

@Target({ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Component
public @interface ControllerAdvice {
    @AliasFor("basePackages")  // basePackages可限制扫描包的范围
    String[] value() default {};

    @AliasFor("value")
    String[] basePackages() default {};

    Class<?>[] basePackageClasses() default {};

    Class<?>[] assignableTypes() default {};

    Class<? extends Annotation>[] annotations() default {};
}

在代码上加上你自己扫描包的范围,因为@ControllerAdvice主要是封装controller层的,所以我们只让它扫描controller即可

在这里插入图片描述

修改完毕,重启服务,再次访问swagger,发现已经可以正常访问!



版权声明:本文为weixin_43829602原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接和本声明。