LEFT JOIN FETCH返回空子列表但DB客户端执行正常的问题排查

结合你描述的情况——SQL在客户端执行正常但JPA返回部分子实体为空，以下是具体的排查方向和解决方法：

1. 检查实体映射的正确性 #

这是最常见的问题根源：

• @OneToMany的mappedBy属性：父实体InventoryDataEntity的@OneToMany注解中，mappedBy的值必须和子实体DriveEntity中@ManyToOne注解对应的属性名完全一致。比如子实体中定义的父实体属性是private InventoryDataEntity inventoryData;，那父实体的注解必须是@OneToMany(mappedBy = "inventoryData")，大小写、拼写都不能错。
• @JoinColumn的列名匹配：子实体DriveEntity的@JoinColumn(name = "xxx")中的name必须和DB2数据库中子表的外键列名完全一致。DB2默认对未加引号的标识符转成大写，如果你数据库列名是INVENTORY_ID，实体里就不能写inventoryId，要么改成大写，要么开启Hibernate的hibernate.globally_quoted_identifiers=true配置（自动给所有标识符加引号，避免大小写冲突）。

2. 分页与LEFT JOIN FETCH的冲突 #

JPA中直接对LEFT JOIN FETCH的查询做分页会导致逻辑错误：
LEFT JOIN FETCH会返回父实体与子实体的笛卡尔积（比如1个父实体对应5个子实体，会返回5行），而分页是基于这个笛卡尔积的行数来截断的。如果你的分页参数是page=0&size=3，那前面那个父实体只会被加载3个子实体，剩下的2个就会丢失，看起来子实体列表不全或为空。

解决方法是分两步查询：

// 第一步：分页查询父实体的ID列表
List<Long> inventoryIds = entityManager.createQuery(
    "SELECT i.id FROM InventoryDataEntity i WHERE 你的查询条件", Long.class)
    .setFirstResult(pageable.getOffset())
    .setMaxResults(pageable.getPageSize())
    .getResultList();

// 第二步：用ID列表查询父实体并预加载子实体
List<InventoryDataEntity> inventoryList = entityManager.createQuery(
    "SELECT i FROM InventoryDataEntity i LEFT JOIN FETCH i.drives WHERE i.id IN :ids", InventoryDataEntity.class)
    .setParameter("ids", inventoryIds)
    .getResultList();

3. 检查equals/hashCode的实现 #

如果父/子实体的equals或hashCode方法用到了关联字段，会导致Hibernate在合并结果集时出错：
比如子实体的hashCode包含了父实体属性，Hibernate会错误地认为不同行的子实体是重复的，从而过滤掉部分数据。正确的实现应该只依赖自身的主键：

// DriveEntity的正确equals/hashCode
@Override
public boolean equals(Object o) {
    if (this == o) return true;
    if (o == null || getClass() != o.getClass()) return false;
    DriveEntity that = (DriveEntity) o;
    return Objects.equals(id, that.id);
}

@Override
public int hashCode() {
    return Objects.hash(id);
}

4. 数据类型不匹配 #

确认父实体的主键类型与子实体的外键类型完全一致：
比如父实体主键是Long，子实体外键也必须是Long，DB2数据库中对应的列类型也要匹配（比如父表主键是BIGINT，子表外键不能是INT），否则会因为类型转换导致关联匹配失败。

5. 查看JPA绑定的SQL参数 #

开启JPA的详细日志（比如Hibernate的hibernate.show_sql=true、hibernate.format_sql=true、hibernate.use_sql_comments=true），查看实际执行的SQL中参数是否正确绑定。有时候代码中的查询条件参数值错误，会导致部分父实体被过滤，但其子实体在数据库中存在，从而出现空列表的错觉。

内容的提问来源于stack exchange，提问作者Muhammad Danish Khan