Spring Data JPA getReferenceById为何仍执行SQL查询？

根据你提供的代码和日志，getReferenceById本应返回延迟加载的代理对象而不触发数据库查询，但实际执行了SQL，以下是几个核心原因及对应解决方案：

1. 方法未处于事务上下文内 #

JPA的延迟加载代理依赖持久化上下文（EntityManager），而持久化上下文的生命周期通常与事务绑定。如果你的getAuthenticatedUserReference方法没有标记@Transactional，调用getReferenceById时，EntityManager无法创建有效的代理对象，只能立即执行SQL查询获取真实实体。

解决方法：给服务方法添加事务注解：

@Service
class UserService(private val userJpaRepository: UserJpaRepository) {

    // ...其他方法

    @Transactional(readOnly = true)
    fun getAuthenticatedUserReference(): UserEntity? {
        val userId = SecurityContextHolder.getContext().authentication.principal as Int
        return userJpaRepository.getReferenceById(userId)
    }
}

2. Kotlin实体类默认是final，无法生成代理 #

Hibernate生成延迟加载代理需要实体类是可继承的（非final），但Kotlin普通类默认是final的。如果你的UserEntity没有用open修饰，Hibernate无法创建代理子类，只能直接查询数据库获取实体实例。

解决方法：

• 手动给实体类添加open关键字：

@Entity
@Table(name = "users")
open class UserEntity(
    @CreationTimestamp
    val createdAtDatetime: String = "",

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    val id: Int = 0,

    @Column(unique = true)
    val email: String = "",

    @Column
    @JsonIgnore
    val password: String = "",

    @Column
    val role: UserRole = UserRole.WATCHER
)

• 或者使用Spring Boot Kotlin插件自动处理：在build.gradle.kts中添加插件，自动将实体类、仓库接口标记为open：

plugins {
    id("org.springframework.boot") version "x.x.x"
    id("io.spring.dependency-management") version "x.x.x"
    kotlin("jvm") version "x.x.x"
    kotlin("plugin.spring") version "x.x.x"
}

3. 测试环境无意触发了代理初始化 #

即使你没有主动访问实体属性，测试框架或工具可能在后台触发了代理初始化：

• 测试方法返回实体后，JUnit或报告工具调用了toString()/hashCode()；
• JSON序列化工具（如Jackson）处理返回结果时访问了字段。

解决方法：

• 测试中避免直接返回实体，或仅持有代理对象不进行序列化、打印操作；
• 自定义实体的toString()方法，仅包含ID字段，避免触发非ID属性的加载。

4. Hibernate配置禁用了事务外懒加载 #

检查配置文件中是否有强制立即加载的设置：

spring.jpa.properties.hibernate.lazy_load_no_trans=false

该配置为false时，事务外无法使用懒加载代理，会直接触发查询。

解决方法：显式配置为true（默认通常为true，可确保生效）：

spring.jpa.properties.hibernate.lazy_load_no_trans=true

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