3.6.xx版本SpringBoot创建基于Swagger接口文档
介绍
基于Swagger构建的JavaAPI文档工具，实现后端功能的测试，并撰写API接口文档。
方法
-
pom.xml中引入依赖,要注意的是，本依赖使用的SpringBoot版本为3.6.xx
<!--Knife4j--><dependency><groupId>com.github.xiaoymin</groupId><artifactId>knife4j-openapi2-spring-boot-starter</artifactId><version>4.4.0</version></dependency> -
application.yaml或yml添加相关配置
server:port: 9080 #后端启动端口 knife4j:enable: true # 是否开启knife4jopenapi:title: XX项目API接口文档 # 标题description: "XX项API接口文档" # 简介email: "shijieheping@666.com" # 邮箱concat: 炜哥 # 联系人url: https://docs.xiaominfo.com # 网址version: v1.0.0 # 版本license: Apache 2.0 # 许可证license-url: https://stackoverflow.com/ # 许可证地址terms-of-service-url: https://stackoverflow.com/ # 服务条款group:default:group-name: default # 分组名称api-rule: package # 分组规则api-rule-resources: # 分组规则对应的包名- cn.sightsnow.zh.controller -
浏览器地址栏输入接口文档地址打开接口文档，其中9080为本机的后端端口
http://localhost:9080/doc.html
-
最后如果启动报错，请查看SpringBoot版本是否高于3.7，请修改Swagger版本或SpringBoot版本。如果访问地址后无接口文档，请先试着检查是否有设置页面拦截。