Java- 深入浅出 MyBatis 注解模式：一对多与多对多查询配置详解

TL;怎么说呢，DR

这篇文章讲解 MyBatis 注解模式下如何实现一对多和多对多关系查询。

主要

• 一对多查询可以通过 @Select@Results@Result@Many 实现。
• 多对多查询通常需要通过中间表完成关联，再结合 @Many 完成嵌套结果映射。
• 注解模式适合简单关系查询和教学演示，复杂 SQL、动态 SQL、性能敏感场景更推荐使用 XML。
• 使用 @Many 时要主要注意字段映射、Mapper 方法方法、外键条件还有 N+ 查询问题。

使用者常见痛点速查卡

• 返回空集合或 null：通常是因为 @Result 与实体类属性不匹配，或子查询的外键写错。
• N+ 查询性能炸裂：大量父记录会触发同等数量的子查询，导致接口响应慢。
• Mapper 方法找不到：@Many 中的全方法写错或方法签名不匹配。
• SQL 语义错误：使用了错误的列名，导致结果不准确。
• 中间表数据缺失：多对多关联返回空列表时先检查中间表是否有对应记录。

一、版本与环境说明

二、MyBatis 注解模式关系查询的主要思路

The essence of relational queries in MyBatis is mapping table relationships to Java object graphs.

• A user may have multiple orders → Java property: List orderList;说起来，
• A user may have multiple roles → Java property: List roleList;

The key annotations when using annotation mode are:

@Select
@Results
@Result
@Many

The most important part is combination of @Result)。 which tells MyBatis to invoke a sub‑query for each parent row.

说到基本结构示例，

@Select
@Results({
@Result,@Result,@Result(property = "orderList",column = "id",javaType = List.class,many = @Many)
})
List findAll;

This configuration tells MyBatis:

• The parent query returns all users.
• The value of column ID @Many.
• The returned list is injected into user's aorderList​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​ property..三、一 对 多 查询：User → Order

  . 查询模型

  User 表和 Order 表是一 对 多 的关系。再看业务含义如下，

  • 一个 使用者 可以 拥有 多个 订单；
  • 一个 订单 只 属于 一个 使用者；

  目标这方面，一次性获取所有使用者还有对应的订单列表。SQL 关系如下：

  ="" ”>user.id = wzkorders.uid
  

  java public class WzkUser { private Integer id;private String username;private String password;private Date birthday;private List orderList;private List roleList;}

  ="" 2="" <="" data-id="“" h="" heading="" 四、一="" 多="" 对="" 查询代码实现="">

  ="" .="" 3="" <="" data-id="“" h="" heading="" usermapper="" 配置="">

  ="" ”> findAllUserAndOrderWithAnnotation;

  从关键点解释来看，

  • @Result 表示把父记录的 ID 当作参数传递给子查询方法。
  • many=@Many 指定子查询所在的 Mapper 完整方法。

  ="" .="" 3="" <="" data-id="“" h="" heading="" ordermapper="" 配置="">

  ="" ”> findByUserIdWithAnnotation;}
  

  ⚠️ 常见错误：误将外键写成主键。