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"/>，不然生成的实体类没有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"/>（默认就是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>下，且<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 导致文件被覆盖 —— 这些问题不会报错，只会静默丢代码。
