MyBatis Spring Boot中collection标签无法获取关联List<ObjectB>问题求助

我之前也碰到过几乎一模一样的坑！结合你的代码场景，咱们从几个关键方向排查和解决：

1. 检查ResultMap中Collection的配置是否正确 #

这是最容易出问题的地方，分两种常用配置方式：

方式一：嵌套查询（分步查询） #

如果你的关联数据量不大，这种方式更清晰，需要给collection指定select属性来调用查询ObjectB列表的语句，同时用column传递关联参数：

<resultMap id="ObjectAResultMap" type="com.yourpackage.ObjectA">
    <!-- 先映射ObjectA自身的字段 -->
    <id property="id" column="id"/>
    <result property="someString" column="some_string"/>
    <!-- 关联映射listB，column传递ObjectA的id作为查询参数 -->
    <collection 
        property="listB" 
        ofType="com.yourpackage.ObjectB" 
        column="id" 
        select="com.yourpackage.mapper.ObjectBMapper.getObjectBListByAId"/>
</resultMap>

<!-- 对应的ObjectB查询语句（在ObjectBMapper.xml中） -->
<select id="getObjectBListByAId" resultType="com.yourpackage.ObjectB">
    SELECT title, somefield FROM object_b WHERE a_id = #{id}
</select>

方式二：嵌套结果（JOIN查询） #

如果你用了JOIN语句，必须确保MyBatis能通过主键区分主表（object_a）和从表（object_b）的记录，避免把多条ObjectB数据当成同一个ObjectA的重复数据。一定要给主表和从表的主键都加上<id>标签：

<resultMap id="ObjectAResultMap" type="com.yourpackage.ObjectA">
    <!-- ObjectA的主键，必须用id标签，MyBatis靠它分组 -->
    <id property="id" column="id"/>
    <result property="someString" column="some_string"/>
    
    <collection property="listB" ofType="com.yourpackage.ObjectB">
        <!-- ObjectB的唯一标识字段，同样用id标签，确保MyBatis能识别不同的ObjectB实例 -->
        <id property="title" column="title"/> <!-- 如果ObjectB有id字段，优先用id -->
        <result property="somefield" column="somefield"/>
    </collection>
</resultMap>

<!-- 对应的JOIN查询，注意字段不要重名，必要时加别名 -->
<select id="getObjectAWithListB" resultMap="ObjectAResultMap">
    SELECT 
        a.id, 
        a.some_string, 
        b.title, 
        b.somefield 
    FROM object_a a 
    LEFT JOIN object_b b ON a.id = b.a_id 
    WHERE a.id = #{id}
</select>

2. 核对JOIN语句的关联条件 #

确认你的JOIN条件是否正确，比如object_b表中是否有对应object_a.id的外键字段（比如a_id），有没有把字段名写错（比如写成aid或者object_a_id）。

3. 检查实体类的Getter/Setter方法 #

MyBatis是通过反射调用Getter/Setter来赋值的，一定要确保listB的方法名正确：

• Getter应该是getListB()而不是getListb()或者其他拼写错误
• Setter应该是setListB(List<ObjectB> listB)

4. 开启MyBatis日志排查 #

如果上面都没问题，打开MyBatis的SQL日志，看看实际执行的SQL和返回的结果集：
在application.yml中添加配置：

mybatis:
  configuration:
    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl

这样能看到：

• 实际执行的SQL语句是否正确
• 数据库返回的结果集中是否包含ObjectB的title和somefield字段
• 字段名和ResultMap中的column是否完全匹配（注意大小写，有些数据库大小写敏感）

内容的提问来源于stack exchange，提问作者ReiSchneider