2025年swagger2配置文件（swagger.enable）

科技前沿 • 2025-06-17 07:29 • 阅读 33

大家好，我是讯享网，很高兴认识大家。

JAVA17 当前最新版本为20，但害怕功能不稳定故选用JAVA17；
SpringBoot 3.0.5 当前最新版本为3.1.0(SNAPSHOT)，但是镜像上找不到该版本的spring-boot-starter-parent包，故退而求其次；
MyBatis-Plus 3.5.3.1 官网上标注的最新版本为3.5.2，3.5.3.1是Maven能拉取到的最高版本的包。选用该版本是因为SpringBoot 3.0.0以上的版本无法使用springfox的包，而是使用springdoc的包，3.5.2版本不支持生成该包的对应注解，但是官网的文档并未对3.5.3.1版本的更新作说明；
MySql 8.0.30 对应自己的安装版本即可；
Swagger OpenAI 3 版本2无法支持SpringBoot 3.0.0以上的版本使用。

pom.xml文件部分代码如下：

进入Spring Initializr，根据下图完成配置，点击生成。

springboot整合mybatisplus generater_spring boot_02

首次启动项目会发现控制台输出No active profile set, falling back to default profiles: default后即终止，在pom.xml中添加如下配置即可解决：

官方文档：https://baomidou.com/

配置信息如下：

添加MapperScan扫描Dao层，代码如下：

⚠️ 注意：

笔者使用MacOS开发，WinOS可能需要修改对应的代码输出路径；
MyBatis-Plus 3.5.3.1版本下，包配置中不存在other自定义文件的输出路径配置，需要通过重写配置引擎的自定义文件输出方法实现，自定义文件输出通过注入配置实现；
执行Main方法，即可生成对应表的代码；
自定义的模版文件放在resources下的templates包中，需对应自己引入的配置引擎选择，笔者选用的是velocity。自定义模版文件可以在mybatis-plus-generator库下的templates包中复制。

代码如下：

我的GitCode代码生成器项目地址，希望多多Star。

官方文档：https://springdoc.org/v2/index.html#Introduction

配置信息如下：

springboot整合mybatisplus generater_spring_03

springboot整合mybatisplus generater_实体类_04

⚠️ 注意：如果配置成工具类，需要在Application中添加ComponentScan扫描该配置代码所属的包，否则代码无法执行。