MyBatisGenerator配置及代码生成教程

本文深入剖析了MyBatis Generator（MBG）在实际开发中高频踩坑的五大核心问题：从因targetRuntime默认为MyBatis3导致Mapper接口无方法，到MySQL 8+连接失败的驱动兼容与URL参数配置；从驼峰映射失效引发Example类字段错位，到Lombok冲突与getter/setter重复生成的编译陷阱；再到mvn命令静默跳过生成的路径、编码及生命周期绑定隐患——每一步都直击开发者痛点，并给出精准、可落地的解决方案，助你避开“配置看似正确却无效”的隐形雷区，真正实现高效、稳定的代码自动生成。

MyBatis Generator生成的Mapper接口为什么没方法？

因为默认配置下，context 的 targetRuntime 是 MyBatis3，它只生成 XML 映射文件和实体类，不生成接口方法 —— 这是很多人卡住的第一步。

解决办法很简单：把 targetRuntime 改成 MyBatis3DynamicSql 或更常用的 MyBatis3Simple（后者会生成带基础 CRUD 的 Mapper 接口）。

• MyBatis3Simple：生成 selectByPrimaryKey、insert 等标准方法，适合快速启动
• MyBatis3DynamicSql：生成基于 org.mybatis.dynamic.sql 的类型安全查询，需额外引入 mybatis-dynamic-sql 依赖
• 别漏掉 ，不然生成的实体类没有 toString()

MBG配置里jdbcConnection连不上MySQL 8+？

MySQL 8 默认用 caching_sha2_password 认证插件，而旧版 JDBC 驱动（如 mysql-connector-java:5.1.x）不支持，直接报 Public Key Retrieval is not allowed 或 Unknown system variable 'query_cache_size'。

必须同时满足三个条件：

• 驱动用 mysql-connector-java:8.0.28+（或至少 8.0.11）
• jdbcConnection 的 connectionURL 加上参数：?serverTimezone=UTC&allowPublicKeyRetrieval=true&useSSL=false
• 确认数据库用户权限允许远程连接（host 不是 localhost 时尤其注意）

生成的Example类字段名和数据库列名对不上？

这是典型的驼峰映射没生效。MBG 默认不会自动把 user_name 转成 userName，除非你在 context 里显式开启：

• 加 （默认就是 false，但有人会误设为 true）
• 确保 table 标签里没写 domainObjectName 或 enableCountByExample 等干扰字段映射的属性
• 如果用了 Lombok，别在实体类上加 @Data 后又让 MBG 生成 getter/setter —— 会编译报错重复方法

示例片段：

<table tableName="sys_user" domainObjectName="SysUser">
  <property name="useActualColumnNames" value="false"/>
</table>

运行mvn mybatis-generator:generate没反应或跳过？

最常见原因是插件没绑定到生命周期，或者配置文件路径不对。

• 检查 pom.xml 里 mybatis-generator-maven-plugin 是否在 下，且 中的 configurationFile 指向正确路径（推荐写成 src/main/resources/generatorConfig.xml）
• 确认 generatorConfig.xml 文件编码是 UTF-8，Windows 下用记事本保存容易带 BOM，导致解析失败
• 执行命令时加上 -X 查看 debug 日志：mvn mybatis-generator:generate -X，重点搜 Cannot find configuration file 或 No tables configured

真正麻烦的点往往不在配置本身，而在数据库连接池初始化前就跑 MBG，或多个 context 共用同一个 targetProject 导致文件被覆盖 —— 这些问题不会报错，只会静默丢代码。

到这里，我们也就讲完了《MyBatisGenerator配置及代码生成教程》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！