从Python转Java后，我靠MyBatis活了下来

去年年底，我决定跳出舒适圈——三年多的Python后端开发干得有点腻，公司技术栈又常年停在Flask + SQLAlchemy + Redis这套“养老组合”，连async都懒得上。眼看大模型火成这样，隔壁组用Spring Cloud Alibaba重构核心链路，天天聊MCP（Model-Code-Prompt）协同、Claude Code辅助生成SQL，我这心里直痒痒。

于是咬牙投了几家Java岗，结果面试官一听说我会Python就皱眉：“我们主力是Java生态，能快速上手MyBatis吗？”
我当时嘴硬：“没问题！”
回家打开VSCode，插件装了Cursor、GitLens、Prettier，但Java项目？一脸懵。

好在我有Cursor这个“外挂”。上周五晚上加班到十点，还在跟一个Invalid bound statement (not found)报错死磕，差点把键盘砸了。最后靠Cursor v0.12.3的智能补全+上下文理解，三分钟定位到XML文件没被Maven打包进resource目录——这种坑，没踩过真不知道有多疼。

今天这篇不是教科书式的教程，而是我这个“Python叛逃者”用血泪换来的MyBatis实战入门总结。如果你也刚从动态语言转静态语言，或者被领导逼着接手老旧Java项目，这篇或许能帮你少掉几根头发。

---

为什么选MyBatis而不是JPA？

先说清楚立场：我不是JPA黑子。但在我们这种中台系统里，业务逻辑复杂、SQL定制需求多（比如要写窗口函数、CTE、分库分表hint），JPA那套“对象映射一切”的理念反而成了枷锁。

举个真实例子：产品经理上周提了个需求，“用户近7天活跃天数TOP100，按城市聚合”。这SQL写起来很简单：

SELECT city, COUNT(DISTINCT user_id) as active_users
FROM user_behavior_log
WHERE event_time >= DATE_SUB(NOW(), INTERVAL 7 DAY)
GROUP BY city
ORDER BY active_users DESC
LIMIT 100;

用JPA？你得建个DTO、配Projection、处理原生查询绑定……而MyBatis？直接写在XML里，接口方法一行搞定：

List<CityActiveStat> selectTopCitiesByActiveUsers();

再加上Cursor最近支持Claude Code v0模式（其实就是深度集成Claude Sonnet做代码理解），我甚至可以让AI帮我把复杂SQL转成MyBatis的<select>标签，连resultMap都自动生成。这效率，谁用谁知道。

---

MyBatis核心三件套：配置、Mapper、实体

别被“框架”俩字吓到。MyBatis本质就是SQL模板引擎 + 对象映射器。搞懂这三个东西，你就入门了。

1. 配置文件：别让XML路径坑了你

mybatis-config.xml 是全局配置，但实际开发中更多用Spring Boot自动配置。重点来了：Mapper XML文件必须放在resources下对应包路径！

我第一次犯的错就是把UserMapper.xml放在src/main/java/com/example/mapper下面——Maven默认不打包.xml到classpath！结果运行时报：

org.apache.ibatis.binding.BindingException: Invalid bound statement (not found): com.example.mapper.UserMapper.selectById

正确姿势：

src
├── main
│   ├── java
│   │   └── com/example/mapper/UserMapper.java
│   └── resources
│       └── com/example/mapper/UserMapper.xml  <-- 必须在这里！

或者干脆用注解写SQL（适合简单CRUD）：

@Select("SELECT * FROM users WHERE id = #{id}")
User selectById(Long id);

但复杂查询我还是倾向XML，可读性高，还能用<where>、<foreach>这些动态标签。

2. Mapper接口：约定大于配置

MyBatis的魔法在于：你只需要定义接口，不用写实现类。框架在启动时通过JDK动态代理生成实现。

关键约束：

• 接口方法名必须和XML中的id一致
• 参数用#{}占位（防止SQL注入），${}慎用（字符串拼接）

比如这个带条件的查询：

// UserMapper.java
List<User> searchUsers(@Param("name") String name, @Param("status") Integer status);

对应的XML：

<!-- UserMapper.xml -->
<select id="searchUsers" resultType="com.example.model.User">
  SELECT * FROM users
  <where>
    <if test="name != null and name != ''">
      AND name LIKE CONCAT('%', #{name}, '%')
    </if>
    <if test="status != null">
      AND status = #{status}
    </if>
  </where>
</select>

注意@Param注解——这是告诉MyBatis参数名对应XML里的test表达式。没加的话，只能用param1, param2，丑到爆。

3. 实体类：别忘了无参构造

MyBatis通过反射实例化对象，所以你的POJO必须有无参构造函数（Lombok的@Data会自动生成，但最好显式确认）。

另外，字段名和数据库列名不一致怎么办？两种解法：

• 方案A：全局配置mapUnderscoreToCamelCase=true（推荐）
• 方案B：在resultMap里手动映射

<resultMap id="UserResultMap" type="User">
  <id property="userId" column="user_id"/>
  <result property="createTime" column="create_time"/>
</resultMap>

我在生产环境一律用方案A。数据库命名规范早就定死了：下划线分隔，Java用驼峰。开启自动映射后，连resultMap都省了。

---

性能与安全：别在生产环境翻车

SQL注入？MyBatis其实很安全

很多人以为#{}和${}区别不大，大错特错！

• #{value} → 预编译参数（?占位），绝对安全
• ${value} → 字符串替换，极易注入

除非你写order by动态字段（比如ORDER BY ${sortField}），否则永远别用${}。如果真要用，务必白名单校验：

private static final Set<String> ALLOWED_SORT_FIELDS = Set.of("name", "create_time");

public List<User> getUsers(String sortField) {
    if (!ALLOWED_SORT_FIELDS.contains(sortField)) {
        throw new IllegalArgumentException("Invalid sort field");
    }
    // ... 调用Mapper
}

N+1查询？用association和collection解决

经典陷阱：查订单列表，每个订单又要查用户信息，结果发了N+1条SQL。

MyBatis提供<association>和<collection>做嵌套查询或嵌套结果映射。

推荐用嵌套结果（JOIN一次查完）：

<resultMap id="OrderWithUserResultMap" type="Order">
  <id property="orderId" column="order_id"/>
  <result property="amount" column="amount"/>
  <association property="user" javaType="User">
    <id property="userId" column="user_id"/>
    <result property="name" column="user_name"/>
  </association>
</resultMap>

<select id="selectOrdersWithUser" resultMap="OrderWithUserResultMap">
  SELECT o.order_id, o.amount, u.user_id, u.name as user_name
  FROM orders o
  JOIN users u ON o.user_id = u.user_id
</select>

比写两次查询高效太多。我们双11压测时，就靠这个把DB QPS从5000降到800。

---

和Cursor + Claude Code怎么配合？

作为重度Cursor用户，我必须吹一波它对MyBatis的支持。

场景1：自动生成Mapper XML

对着Java接口，按Cmd+K呼出Cursor，输入：

“为这个Mapper生成对应的XML文件，包含resultMap和动态查询”

它会根据字段类型、方法参数，自动生成完整XML，连<where>标签都给你加上。上次重构一个老模块，20个接口，10分钟搞定。

场景2：SQL优化建议

把慢SQL贴进去，问：

“这个查询在MySQL 8.0下如何优化？是否需要索引？”

Claude Code v0能结合执行计划给出建议。比如提示我给event_time加复合索引(city, event_time)，查询速度从1.2s降到80ms。

场景3：迁移Python ORM逻辑

最爽的是这个：把SQLAlchemy的query代码扔给Cursor：

session.query(User).filter(User.status == 1).order_by(User.create_time.desc()).limit(10)

让它转成MyBatis XML：

<select id="selectActiveUsers" resultType="User">
  SELECT * FROM users
  WHERE status = #{status}
  ORDER BY create_time DESC
  LIMIT 10
</select>

简直像有个懂两种语言的同事在旁边帮你翻译。

---

真实项目配置参考（Spring Boot版）

别再手写DataSource了！直接上starter：

<dependency>
    <groupId>org.mybatis.spring.boot</groupId>
    <artifactId>mybatis-spring-boot-starter</artifactId>
    <version>3.0.3</version>
</dependency>

application.yml 关键配置：

mybatis:
  configuration:
    map-underscore-to-camel-case: true
    cache-enabled: false  # 生产环境慎用二级缓存
  mapper-locations: classpath*:mapper/**/*.xml
  type-aliases-package: com.example.model

配置项	建议值	说明
mapUnderscoreToCamelCase	true	自动映射下划线→驼峰
cacheEnabled	false	二级缓存易引发数据不一致
lazyLoadingEnabled	false	延迟加载在Web场景意义不大
aggressiveLazyLoading	false	避免意外触发N+1

---

最后几句真心话

MyBatis不是银弹，但它足够简单、足够透明。你写的SQL什么样，执行的就是什么样——这对线上问题排查太友好了。上周运维半夜call我，说某个接口慢，我直接看日志里的SQL，复制到Navicat跑一下，EXPLAIN一看缺索引，十分钟搞定。

相比之下，某些全自动ORM，SQL藏在框架深处，debug时恨不得掀桌子。

现在我已经能熟练用Java + MyBatis + Cursor 写业务了。虽然偶尔还是会怀念Python的list comprehension，但看到Claude Code v0能帮我把Python思维无缝转成Java持久层代码，也就释然了。

毕竟，工具是为人服务的。无论是Python还是Java，无论是v0还是未来v1，只要能让我按时下班、少背锅，就是好技术。

对了，下周面试新公司，据说他们用MyBatis Plus……希望Cursor也能搞定 😅