SpringBoot2.6.3使用Swagger3启动空指针

前后端分离使用swagger把接口信息展示给前端开确实非常方便，swagger3的maven依赖也只有一个非常方便，然后注解和配置都改了，还可以直接导入showdoc里面。

但是今天整合到自己的项目的时候发现启动不了，报错：

[rest] 2022-03-05 09:29:59 [main] WARN  o.s.b.w.s.c.AnnotationConfigServletWebServerApplicationContext - Exception encountered during context initialization - cancelling refresh attempt: org.springframework.context.ApplicationContextException: Failed to start bean 'documentationPluginsBootstrapper'; nested exception is java.lang.NullPointerException

这里需要修改一下配置，添加注解@EnableWebMvc即可。

访问地址：/swagger-ui/index.html

新版注解

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

更多使用方法查看官网：https://springdoc.org/