springboot4 swagger3

fanruitian2025-12-09 8:31

swagger文档链接https://springdoc.org/#migrating-from-springfox

引入依赖：

复制代码

 <dependency>
            <groupId>org.springdoc</groupId>
            <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
            <version>2.8.14</version>
        </dependency>

完成！

访问：http://localhost:8080/swagger-ui/index.html 查看

swagger2 注解一般以API开头，例如Api ApiOpration ApiParam ApiModel等，Swagger3替换了一些

@Api → @Tag
@ApiIgnore → @Parameter(hidden = true) or @Operation(hidden = true) or @Hidden
@ApiImplicitParam → @Parameter
@ApiImplicitParams → @Parameters
@ApiModel → @Schema
@ApiModelProperty(allowEmptyValue = true) → @Schema(nullable = true)
@ApiModelProperty → @Schema
@ApiOperation(value = "foo", notes = "bar") → @Operation(summary = "foo", description = "bar")
@ApiParam → @Parameter
@ApiResponse(code = 404, message = "foo") → @ApiResponse(responseCode = "404", description = "foo")