本文详解如何在 MyBatis 的 resultMap 中为同一个 Java 内部类（如 Card）配置两个独立的 association 映射，解决因列名冲突导致第二个关联对象为 null 的典型问题。
本文详解如何在 mybatis 的 `resultmap` 中为同一个 java 内部类（如 `card`）配置两个独立的 `association` 映射，解决因列名冲突导致第二个关联对象为 `null` 的典型问题。
在 MyBatis 实体映射中，当一个主对象（如 Hand）需关联多个同类型子对象（如两个 Card 实例：card1 和 card2），若直接复用同一 resultMap（如共用 cardMap），极易出现字段覆盖或映射错位——典型表现为 card1 正常赋值而 card2 为 null。根本原因在于：SQL 查询结果集中，两张 Card 表（c1 和 c2）的字段（如 id、number、color）若未显式重命名，将发生列名冲突；MyBatis 在解析 resultMap 时无法区分“哪个 id 属于 c1、哪个属于 c2”，最终仅能正确绑定第一个匹配项。
✅ 正确实践：为每个关联定义独立的 resultMap + 列别名
核心原则是 “一一对齐”：每个 association 必须绑定唯一、无歧义的字段集。需同时满足以下三点：
- SQL 层：对两张关联表的字段使用语义化别名（如 c1number, c2color），避免原始列名重复；
-
映射层：为每个关联创建专属 resultMap，其
标签严格指向对应别名； - 关联层：在主 resultMap 中分别引用这两个独立的 resultMap。
以下是修正后的完整配置示例：
<!-- 专用于 card1 的映射 -->
<resultmap id="cardMap1" type="com.company.handsmap.Card"><id column="c1id" property="id"></id><result column="c1number" property="number"></result><result column="c1color" property="color"></result></resultmap><!-- 专用于 card2 的映射 --><resultmap id="cardMap2" type="com.company.handsmap.Card"><id column="c2id" property="id"></id><result column="c2number" property="number"></result><result column="c2color" property="color"></result></resultmap><!-- 主 Hand 映射 --><resultmap id="handMap" type="com.company.handsmap.Hand"><id column="id" property="id"></id><association property="card1" resultmap="cardMap1"></association><association property="card2" resultmap="cardMap2"></association></resultmap><!-- SQL 查询：显式别名确保字段唯一性 --><select id="getAllHand" resultmap="handMap">
SELECT
H.*,
c1.id AS c1id, c1.number AS c1number, c1.color AS c1color,
c2.id AS c2id, c2.number AS c2number, c2.color AS c2color
FROM Hand H
LEFT JOIN Card c1 ON H.card1_id = c1.id
LEFT JOIN Card c2 ON H.card2_id = c2.id
</select>
⚠️ 关键注意事项
- 切勿复用 resultMap：即使类结构完全相同，card1 和 card2 的数据源（c1 vs c2）在结果集中是物理分离的，必须通过不同别名和不同 resultMap 隔离映射上下文。
-
标签不可省略 ：MyBatis 依赖字段进行对象实例缓存与去重，若 c1id/c2id 为 NULL（如 LEFT JOIN 未匹配），需确认业务逻辑是否允许空值，必要时添加 notNullColumn 属性控制映射条件。 - 列别名命名规范：推荐采用 表别名+字段名（如 c1number）而非纯数字后缀（如 number1），提升可读性与可维护性。
-
替代方案：嵌套 resultMap（高级用法）
若希望减少 resultMap 数量，可改用内联映射（但需确保列别名唯一）： <association property="card1" javatype="com.company.handsmap.Card"><id column="c1id" property="id"></id><result column="c1number" property="number"></result><result column="c1color" property="color"></result></association><association property="card2" javatype="com.company.handsmap.Card"><id column="c2id" property="id"></id><result column="c2number" property="number"></result><result column="c2color" property="color"></result></association>
✅ 总结
MyBatis 对多对一关联的映射本质是基于列名到属性的静态绑定。当同一类型被多次关联时，“列名唯一性”是正确映射的前提。通过 SQL 别名 + 独立 resultMap 的组合策略，可彻底规避字段覆盖问题，确保每个嵌套对象精准承载其对应的数据源。此模式同样适用于 collection 场景（如一个 Hand 包含多个 Card 的列表），只需将 association 替换为 collection 并调整 ofType 即可。
