MyBatis-Plus 是基于 MyBatis 的 Java 增强框架，非 MySQL 内置组件；它通过 JDBC 封装简化单表 CRUD，支持动态条件查询、批量插入回填 ID 和逻辑删除，但不支持多表 JOIN 或 MySQL 特有语法，需手动处理。
MyBatis-Plus 不是 MySQL 的一部分，也不是 MySQL 自带的类库——它是一个基于 MyBatis 的 Java 框架增强工具，专为简化单表 CRUD 开发而设计，和 MySQL 数据库本身无绑定关系，但常与 MySQL 配合使用。
为什么说 MP 和 MySQL 是“配合”而非“内置”？
MyBatis-Plus 本质是 JDBC 层的封装，它不操作数据库引擎、不解析 SQL 语法、也不改写 MySQL 的协议或存储过程。它只是帮你少写 XML 和重复 SQL，最终所有语句仍通过 mysql-connector-java 发送给 MySQL 执行。
- 你换 Oracle / PostgreSQL，只要改驱动和 URL，MP 代码几乎不用动
- 你用 MySQL 8.0+ 的窗口函数、JSON 类型，MP 默认不支持——得手写
@Select或用QueryWrapper.last("...")拼接 - MySQL 的严格模式（
STRICT_TRANS_TABLES）可能让 MP 自动生成的 INSERT 因 null 值报错，需检查allowMultiQueries和字段默认值配置
MP 真正加速开发的三个典型场景
不是所有场景都适合 MP；它最省力的地方集中在“单表 + 标准字段 + 明确主键”的情形：
-
批量插入但要返回自增 ID：用
saveBatch(list)+@TableId(type = IdType.AUTO)，比原生 MyBatis 少写 10 行 -
动态条件分页查询：比如「年龄 > 18 且邮箱含 @qq.com 且未删除」，用
QueryWrapper链式构造，避免手拼 SQL 注入风险 -
逻辑删除统一拦截：配置
@TableLogic后，所有mapper.selectList()自动追加AND deleted = 0，连 XML 都不用碰
容易被忽略的兼容性雷区
很多项目上线后才发现问题，往往卡在这些细节：
- MySQL 时区配置不一致：
serverTimezone=Asia/Shanghai必须显式写在 JDBC URL 里，否则Date字段查出来晚 8 小时 - MP 3.4.0+ 内置分页插件，但如果你用了
mybatis-plus-generator3.3.x，生成的Page类可能导入错包（com.baomidou.mybatisplus.extension.plugins.pagination.Pagevs 老版本路径） - 字段名含下划线（如
user_name），MP 默认开启驼峰转换（map-underscore-to-camel-case: true），但如果实体类用@TableField("user_name")显式指定，反而会覆盖自动映射，导致查不到值
spring:
datasource:
url: jdbc:mysql://localhost:3306/mybatis_plus?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true&useSSL=false
username: root
password: root
mybatis-plus:
configuration:
log-impl: org.apache.ibatis.logging.stdout.StdOutImpl
global-config:
db-config:
logic-delete-field: deleted
logic-delete-value: 1
logic-not-delete-value: 0
真正要用好 MP，关键不是堆功能，而是清楚它在哪停步——比如多表 JOIN、复杂子查询、存储过程调用，它不会替你抽象，这时候就得退回到 @Select 或 XML。别指望一个增强工具解决所有数据访问问题。
