mybatis 3.4+ 要求 jdk 8+，jdk 11+ 需添加 jakarta.xml.bind-api；配置文件须置于 classpath 根路径；mysql 8 驱动需指定 servertimezone；mapper xml 必须在 mybatis-config.xml 中注册且 namespace 与接口全限定名一致。
MyBatis 3.4+ 和 JDK 8+ 的版本兼容问题
MyBatis 3.4 开始不再支持 JDK 7，如果你用的是 JDK 11 或 JDK 17，别直接抄老教程里的 mybatis-3.2.8.jar——它会在启动时抛 java.lang.NoClassDefFoundError: javax/xml/bind/annotation/XmlRootElement。这不是你配置错了，是 JAXB 被 JDK 11 移除了。
解决方法很简单：用 MyBatis 官方推荐的现代组合。
- 选
mybatis-3.5.13（或更高） +mybatis-spring-2.0.7（对应 Spring 5.3+） - 如果项目用 Maven，
mybatis本身不依赖 JAXB，但你的spring-jdbc或数据库驱动可能间接需要；JDK 11+ 下需显式加jakarta.xml.bind:jakarta.xml.bind-api - 验证是否生效：启动后看日志里有没有
Creating a new SqlSessionFactory，而不是卡在类加载异常
SqlSessionFactoryBuilder.build() 报空指针的常见原因
新手最常卡在这一步：调 new SqlSessionFactoryBuilder().build(inputStream) 直接抛 NullPointerException，但 inputStream 明明没打印 null——其实是资源路径没对上。
MyBatis 默认只从 classpath 根目录找 mybatis-config.xml，不会自动扫描 src/main/resources 下的子文件夹。
立即学习“Java免费学习笔记（深入）”；
- 确保配置文件放在
src/main/resources/mybatis-config.xml，不是src/main/resources/config/mybatis-config.xml - 用
Resources.getResourceAsStream("mybatis-config.xml")加载，别用new FileInputStream(...)—— 后者走的是文件系统路径，打包成 jar 后必然失败 - 检查 XML 是否有语法错误：比如
<configuration></configuration>标签没闭合，或<environments></environments>缺了default属性，这时build()会静默失败再抛 NPE
MySQL 驱动 8.x 连接 URL 不写时区会连不上
用 mysql-connector-java:8.0.33 时，如果 jdbcUrl 还沿用老写法 jdbc:mysql://localhost:3306/test，启动会卡住几秒后报 Could not create connection to database server，根本看不到 SQL 执行。
这是 MySQL 8 强制要求服务端与客户端时区一致导致的，默认尝试读系统时区失败就放弃连接。
- 必须加上
serverTimezone=UTC或serverTimezone=Asia/Shanghai，完整写法：jdbc:mysql://localhost:3306/test?serverTimezone=UTC&useUnicode=true&characterEncoding=UTF-8 -
&是 HTML 实体，在 XML 配置里要写成&，否则解析失败 - 别信某些博客说“加
useSSL=false就行”——那是掩盖问题，真正根源是时区
Mapper 接口找不到对应的 XML 文件
写了 UserMapper.java，也写了 UserMapper.xml，但执行 session.selectList("selectUsers") 报 org.apache.ibatis.binding.BindingException: Invalid bound statement (not found)。
根本原因不是文件名没对上，而是 MyBatis 没把 XML 注册进 Configuration。
-
mybatis-config.xml里必须有<mappers><mapper resource="com/example/mapper/UserMapper.xml"></mapper></mappers>，路径是 classpath 相对路径，不是包名 - XML 文件里的
namespace必须和 Mapper 接口全限定名完全一致，比如namespace="com.example.mapper.UserMapper"，少个.mapper都不行 - 接口方法名要和 XML 中
<select id="selectUsers"></select>的id严格匹配，大小写敏感，不能靠 IDE 自动生成糊弄过去
这些地方任意一个出错，MyBatis 都不会报“找不到 XML”，而是等你真调方法时才甩出那个让人摸不着头脑的绑定异常。
