Swagger2 2.7.x踩坑记

最新推荐文章于 2025-06-27 16:55:21 发布

CooperXJ

最新推荐文章于 2025-06-27 16:55:21 发布

阅读量480

点赞数

CC 4.0 BY-SA版权

分类专栏： Spring 文章标签： swagger2 java

本文链接：https://blog.csdn.net/weixin_42340926/article/details/109602902

Spring 专栏收录该内容

5 篇文章

订阅专栏

本文对比了Swagger2 2.7.0与2.9.0版本之间的区别，主要聚焦于ApiKey处理上的不同。2.7.0版本存在每次填写ApiKey即发送请求的Bug，在2.9.0中得到修复；同时指出了2.7.0版本中ApiKey在所有路径中被添加的问题。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

Swagger2 2.7.x踩坑（与Swagger2 2.9.0比较）

一开始使用的是

<dependency>
  <groupId>io.springfox</groupId>
  <artifactId>springfox-swagger2</artifactId>
  <version>2.7.0</version>
</dependency>
<dependency>
  <groupId>io.springfox</groupId>
  <artifactId>springfox-swagger-ui</artifactId>
  <version>2.7.0</version>
</dependency>

在此版本中有一次的几个Bug

每次填写一个ApiKey都会发送请求

在这里插入图片描述

但是在2.9.0中被解决

所有的ApiKey在任何路径中都被添加了，但是有些没有被主动添加的ApiKey在需要被认证的路径中没有被添加

private List<SecurityReference> defaultAuth() {
        List<SecurityReference> result = new ArrayList<>();
        AuthorizationScope authorizationScope = new AuthorizationScope("global", "accessEverything");
        AuthorizationScope[] authorizationScopes = new AuthorizationScope[1];
        authorizationScopes[0] = authorizationScope;
        //将ApiKey添加到每次需要进行认真的请求中  但是在swagger2.7.0 中除了需要认证的路径其他的任何路径都可以使用该APIKey
        result.add(new SecurityReference("Authorization", authorizationScopes));
        result.add(new SecurityReference("sessionId",authorizationScopes));
        return result;
    }