MyBatis Generator默认不生成Mapper接口方法，因targetRuntime默认为MyBatis3；应改为MyBatis3Simple或MyBatis3DynamicSql，并注意驱动版本、驼峰映射、插件绑定等配置。

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

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

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

• MyBatis3Simple：生成 selectByPrimaryKey、insert 等标准方法，适合快速启动
• MyBatis3DynamicSql：生成基于 org.mybatis.dynamic.sql 的类型安全查询，需额外引入 mybatis-dynamic-sql 依赖
• 别漏掉 <plugin type="org.mybatis.generator.plugins.ToStringPlugin"></plugin>，不然生成的实体类没有 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 里显式开启：

• 加 <property name="useActualColumnNames" value="false"></property>（默认就是 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 是否在 <plugins></plugins> 下，且 <configuration></configuration> 中的 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 导致文件被覆盖 —— 这些问题不会报错，只会静默丢代码。