Hibernate一对一映射关联实体查询返回null问题排查

从你的代码和实体定义来看，查询TableA时关联的TableB始终为null，主要是关联加载逻辑和映射配置的问题，我来逐一拆解并给出修复方案：

1. EAGER关联未触发自动加载（核心问题） #

你虽然配置了FetchType.EAGER，但生成的SQL只查询了TableA本身，没有关联TableB的语句。这是因为Hibernate没有正确识别你的复合主键关联规则，导致自动EAGER加载失效。

修复方法：在Criteria查询中显式指定加载关联的TableB：

CriteriaBuilder builder = session.getCriteriaBuilder();
CriteriaQuery<TableA> criteriaQuery = builder.createQuery(TableA.class);
Root<TableA> from = criteriaQuery.from(TableA.class);
// 显式触发关联加载，注意属性名要和实体中定义的一致（这里是大写的TableB）
from.fetch("TableB"); 
criteriaQuery.select(from);

调整后生成的SQL会包含LEFT JOIN TableB的语句，就能正常加载关联数据了。

2. @OneToOne关联映射的合理性校验 #

你的关联逻辑是用TableA的id关联TableB的parentId、TableA的active关联TableB的active，但TableB的主键是id+active，parentId并非主键列：

• 如果(parentId, active)组合在TableB中是唯一的，@OneToOne是合理的，但建议在@JoinColumns上添加unique=true明确唯一性约束：

@OneToOne(fetch = FetchType.EAGER)
@JoinColumns({
    @JoinColumn(name = "id", referencedColumnName = "parentId", unique = true),
    @JoinColumn(name = "active", referencedColumnName = "active", unique = true)}
)
@Where(clause = "active=1")
private TableB tableB = null; // 建议属性名改为小写，符合Java命名规范

• 如果(parentId, active)组合在TableB中不唯一，应该改用@ManyToOne关联，再结合@Where注解筛选出你需要的唯一TableB记录。

3. 复合主键的潜在问题 #

虽然你没展示复合主键定义，但必须确保复合主键类：

• 正确实现equals()和hashCode()方法（Hibernate依赖这两个方法匹配关联实体）
• 符合JPA规范（比如实现Serializable，使用@Embeddable或@IdClass注解）

4. @Where注解的验证 #

@Where(clause = "active=1")会过滤掉TableB中active≠1的记录，如果你关联的TableB记录active不是1，即使关联正确，TableB也会是null。可以先暂时去掉该注解测试，确认能加载数据后再重新添加。

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