即使 Swagger 添加为 Maven 依赖项，也无法导入 @ApiParam 或 @ApiModelProperty 注释

Question

我正在开发一个项目，我们用 Swagger 记录后端的 API。我想为 Swagger 使用基于注释的配置。对于我的控制器类，使用@Tag,@Operation和@ApiResponses工作得很好，可以使用以下语句导入它们：

import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.responses.ApiResponse;
import io.swagger.v3.oas.annotations.responses.ApiResponses;
import io.swagger.v3.oas.annotations.tags.Tag;

但是，如果我尝试将@ApiParam或添加@ApiModel到我的代码中，我无法以任何方式导入它们。

在我的中POM.xml，我添加了 Swagger 作为以下依赖项：

<!-- https://mvnrepository.com/artifact/io.swagger.core.v3/swagger-annotations -->
<dependency>
    <groupId>io.swagger.core.v3</groupId>
    <artifactId>swagger-annotations</artifactId>
    <version>2.1.11</version>
</dependency>

我在这里缺少什么？我尝试遵循这篇 Baeldung 文章和示例代码，但是我无法让它工作。谢谢您的帮助！

Answer 1

“问题”是使用了Springdoc，最初我假设使用了 Springfox 或普通的 Swagger 2 依赖项，因为它没有从代码库中删除。

要解决此问题，我们只需添加正确的依赖项并使用新注释，这些注释将映射到旧注释，如此处所述。