MyBatis关联查询中必须使用SQL列别名配合resultMap映射，以解决多表JOIN时字段名冲突及命名风格不一致问题；别名需唯一且与resultMap中column值严格一致，才能正确绑定Java属性。
MyBatis 在关联查询中使用别名映射属性，核心目的是解决数据库字段名与 Java 实体类属性名不一致的问题，尤其在多表 JOIN 查询时，不同表可能有同名列（如 id、name），或字段命名风格（下划线 vs 驼峰）不匹配。直接用 resultType 会失败，必须借助 resultMap + 列别名来精准控制映射。
✅ 明确字段别名是 SQL 层的前置动作
在 <select> 的 SQL 中，对所有参与关联的字段显式指定别名，确保每个字段名唯一且语义清晰：
<select id="selectUserWithCard" resultMap="UserWithCardResultMap">
SELECT
u.id AS user_id,
u.username AS user_name,
u.email AS user_email,
c.id AS card_id,
c.number AS card_number,
c.address AS card_address
FROM user u
LEFT JOIN id_card c ON u.card_id = c.id
</select>⚠️ 注意：
AS可省略，但别名必须写；避免用*，否则无法区分同名列。
✅ 在 resultMap 中按别名绑定属性
resultMap 不认原始字段名，只认你 SQL 中写的别名（column 值），然后映射到 Java 对象的 property：
<resultMap id="UserWithCardResultMap" type="User">
<!-- User 主体字段 -->
<id property="id" column="user_id"/>
<result property="username" column="user_name"/>
<result property="email" column="user_email"/>
<!-- 关联的 IdCard 对象（一对一） -->
<association property="idCard" javaType="IdCard">
<id property="id" column="card_id"/>
<result property="number" column="card_number"/>
<result property="address" column="card_address"/>
</association>
</resultMap>-
property="idCard"是User类里的字段名（类型为IdCard） -
javaType明确告诉 MyBatis 这个关联对象的完整类名 - 内部
<id>和<result>的column必须和上面 SQL 的别名完全一致（大小写敏感）
✅ 处理常见陷阱
-
别名重复或遗漏：比如忘了给
c.id加别名，导致column="id"同时匹配u.id和c.id，MyBatis 可能取错值或报错。 -
空关联记录（LEFT JOIN）：若
id_card表无对应数据，card_id等字段为NULL，MyBatis 仍会创建IdCard对象，其属性为null—— 这是正常行为，无需额外判空处理。 -
驼峰自动转换失效：开启
mapUnderscoreToCamelCase=true后，仅对简单字段生效；关联对象内部字段仍需显式别名 + resultMap 映射，不能依赖自动转换。
✅ 替代方案对比（不推荐但需知道）
| 方式 | 是否需要别名 | 说明 |
|---|---|---|
resultType="User" |
❌ 不行 | 无法处理嵌套对象，字段冲突时直接映射失败 |
resultMap + 列别名 |
✅ 必须 | 最清晰、可控、兼容性最好 |
resultMap + 自动映射（无别名） |
❌ 不可靠 | 仅当所有字段名恰好匹配属性名才可行，JOIN 场景几乎不可用 |
不复杂但容易忽略
