为何JPA的getReference()方法未按预期工作？

我之前在项目里也踩过EntityManager.getReference()的坑，结合你的实体类定义和Spring Boot版本，咱们来拆解常见的问题场景和解决办法：

1. 最常见的坑：懒加载代理导致的LazyInitializationException #

getReference()和find()最大的区别是，它返回的是懒加载代理对象，不会立刻去数据库查询数据。只有当你第一次访问实体的非ID属性时，才会触发数据库查询。但如果这时候EntityManager已经关闭（比如事务结束后），就会抛出LazyInitializationException。

解决办法： #

确保调用getReference()和后续访问实体属性的操作都在同一个事务上下文里：

• 给业务方法加上@Transactional注解，让Spring帮你管理事务生命周期：

@Service
public class PersonService {
    @Autowired
    private EntityManager em;

    @Transactional
    public Person getPerson(Long id) {
        Person person = em.getReference(Person.class, id);
        // 提前访问一个属性触发数据加载，避免后续事务外访问报错
        person.getFullName();
        return person;
    }
}

2. 不存在的ID导致的EntityNotFoundException #

如果你传入的ID在数据库中不存在，getReference()不会立刻报错——因为它只是创建了代理对象。但当你第一次访问实体属性时，就会抛出EntityNotFoundException。

解决办法： #

• 如果需要提前验证ID是否存在，可以先用find()方法查询（find()会立刻访问数据库，不存在返回null）：

Person existingPerson = em.find(Person.class, id);
if (existingPerson == null) {
    // 处理ID不存在的逻辑
    throw new IllegalArgumentException("Person with id " + id + " not found");
}
Person personRef = em.getReference(Person.class, id);

• 或者在访问属性时捕获异常做处理。

3. Jackson序列化代理对象的问题（结合你的Spring Boot版本） #

你的项目依赖了Jackson，如果你在接口中直接返回getReference()得到的代理对象，Spring MVC在请求结束后会关闭EntityManager，这时候Jackson序列化时尝试访问所有属性，就会触发懒加载异常。

解决办法： #

• 方案一：忽略代理相关属性：在实体类上添加Jackson注解，跳过代理的内部属性：

@Entity
@Table(name="people")
@JsonIgnoreProperties({"hibernateLazyInitializer", "handler"})
public class Person {
    // 你的字段、getter和setter
}

• 方案二：转换为真实实体：如果用的是Hibernate作为JPA实现，可以用Hibernate.unproxy()把代理转成真实实例：

@Transactional
public Person getPerson(Long id) {
    Person personProxy = em.getReference(Person.class, id);
    return (Person) Hibernate.unproxy(personProxy);
}

• 方案三：改用find()：如果不需要懒加载的优化，直接用em.find(Person.class, id)返回真实实体，避免代理带来的问题。

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