在Java后端项目中，持久层框架的选择直接影响业务接口的开发速度。MyBatis Plus是对MyBatis的增强工具，它在保留原生MyBatis灵活性的同时，通过内置通用接口和代码生成能力，减少了开发人员的重复劳动。下面以Spring Boot环境为例，说明如何将其整合进后端工程并真正提升效率。
一、引入依赖与基础配置
要在Spring Boot项目中使用MyBatis Plus，首先需要在构建文件中添加官方提供的启动器。以Maven为例，引入mybatis-plus-boot-starter即可，它已经帮我们处理好与Spring容器的自动装配关系，不必再单独引入MyBatis核心包。
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus-boot-starter</artifactId>
<version>3.5.3</version>
</dependency>
依赖就绪后，在application.yml中配置数据源以及MyBatis Plus的全局属性。相比原生MyBatis，这里可以指定逻辑删除字段、表名前缀等通用规则，避免在每個实体上重复声明。例如通过global-config下的db-config统一设置逻辑删除列名为deleted，框架会自动在查询时拼接条件。
spring:
datasource:
url: jdbc:mysql://127.0.0.1:3306/demo
username: root
password: root
mybatis-plus:
global-config:
db-config:
logic-delete-field: deleted
table-prefix: t_
configuration:
log-impl: org.apache.ibatis.logging.stdout.StdOutImpl
这种集中式配置让团队规范更容易落地。新成员接手项目时，不需要翻找分散的XML去理解删除逻辑，只看全局配置就能明白数据层约定。从维护角度看，这比在SQL里手写is_deleted = 0要稳妥得多。
二、使用通用Mapper简化CRUD
原生MyBatis要求为每个表编写Mapper接口方法和对应XML语句。MyBatis Plus提供的BaseMapper接口已经内置了insert、deleteById、updateById、selectList等常用方法，业务实体只需继承它就能直接调用。
public interface UserMapper extends BaseMapper<User> {
// 无需写基础CRUD，框架已提供
}
在Service层，可以借用框架提供的ServiceImpl进一步简化。比如下面这段代码，不用写任何SQL就能完成分页查询与条件过滤，条件构造器QueryWrapper以链式方式描述where部分，比拼接字符串安全，也避免SQL注入。
public class UserServiceImpl extends ServiceImpl<UserMapper, User> implements UserService {
public IPage<User> queryByAge(int age, int pageNum, int pageSize) {
QueryWrapper<User> wrapper = new QueryWrapper<>();
wrapper.ge("age", age).orderByDesc("create_time");
Page<User> page = new Page<>(pageNum, pageSize);
return this.page(page, wrapper);
}
}
通用Mapper带来的不只是少写代码，更重要的是统一了操作风格。当多个模块都使用相同的方法签名时， reviewer能够快速理解逻辑，新人也不会因为各人SQL写法差异而踩坑。对于字段变动频繁的中后台系统，这种抽象能显著降低改动成本。
三、代码生成器解放双手
如果项目里表数量较多，连实体类、Mapper、Service都手写仍然费时。MyBatis Plus自带代码生成器AutoGenerator，可以根据数据库表结构反向生成上述全部基础文件，甚至包括Controller。
public class CodeGen {
public static void main(String[] args) {
AutoGenerator generator = new AutoGenerator();
generator.setDataSource(new DataSourceConfig.Builder(
"jdbc:mysql://127.0.0.1:3306/demo", "root", "root").build());
generator.setGlobal(new GlobalConfig.Builder().outputDir("./src/main/java").author("dev").build());
generator.setPackage(new PackageConfig.Builder().parent("com.example").build());
generator.setStrategy(new StrategyConfig.Builder().addInclude("t_user").entityBuilder().enableLombok().build());
generator.execute();
}
}
运行后，工程里会自动出现User.java、UserMapper.java、UserServiceImpl.java等结构统一的代码。开发人员只需要在生成好的Service中补充复杂业务逻辑，基础增删改查完全不用管。配合Lombok注解，实体类连getter和setter都省了。
不过要注意，生成器产出的是模板代码，不宜直接提交到生产分支而不做检查。建议将生成动作放在独立的工具模块，或仅在新建表时执行一次，之后靠人工维护业务扩展部分，防止自动覆盖导致定制逻辑丢失。
四、分页插件与逻辑删除的内置支持
很多团队在原生MyBatis中自己写分页拦截器，容易因数据库方言出错。MyBatis Plus通过PaginationInnerInterceptor统一处理分页，只需注册一个Bean，所有page方法自动生效。
@Configuration
public class MybatisPlusConfig {
@Bean
public MybatisPlusInterceptor mybatisPlusInterceptor() {
MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL));
return interceptor;
}
}
逻辑删除前面已在配置中提及，它的价值在于让删除操作变成更新标记，数据可恢复也方便审计。框架在增删改查时自动忽略或填充deleted字段，业务代码完全无感。相比自行在每一条SQL后加条件，这种方式减少了遗漏风险。
综合来看，从依赖接入到生成器使用，MyBatis Plus把后端开发中机械的部分封装起来。团队可以把精力放在业务建模和接口设计上，而不是反复写相似的持久层代码。对于追求交付速度的项目，这套整合方案值得直接在脚手架里预置。
MyBatis_Plusjava后端代码生成器修改时间：2026-08-05 00:39:28