SpringBoot集成Hibernate操作嵌入式H2数据库时遇属性访问异常

嘿，这个问题我之前帮好几个开发者排查过，咱们一步步来搞定它：你遇到的org.hibernate.property.access.spi.PropertyAccessException本质是Hibernate没法正常访问实体类的私有字段，结合你的场景，大概率是这几个原因，对应解决方案如下：

1. 实体类ID字段的访问策略不匹配 #

如果你把@Id注解直接标在私有字段上，但没明确告诉Hibernate直接访问字段，它可能会试图通过getter/setter来访问，而如果没有对应的方法或者方法权限不对，就会触发错误。

解决办法：
在实体类上添加@Access(AccessType.FIELD)注解，明确指定Hibernate直接访问字段而非通过方法：

import javax.persistence.Access;
import javax.persistence.AccessType;
import javax.persistence.Entity;
import javax.persistence.Id;

@Entity
@Access(AccessType.FIELD)
public class Customer {
    @Id
    private int id;
    // 其他字段、构造方法和业务方法
}

2. ID字段的类型选择不当 #

如果你的ID用的是基本类型int，当Hibernate处理未赋值的ID（比如新增实体时还没生成ID），基本类型无法容纳null值，会间接引发字段访问的异常。

解决办法：
把ID字段改成包装类型Integer，同时对应的getter/setter也同步修改：

@Entity
public class Customer {
    @Id
    private Integer id;

    public Integer getId() {
        return id;
    }

    public void setId(Integer id) {
        this.id = id;
    }
    // 其他字段和方法
}

3. 依赖版本冲突或缺失 #

如果手动引入了单独的hibernate-core依赖，或者H2数据库的版本和SpringBoot不兼容，会导致类加载异常，进而引发字段访问错误。

解决办法：
检查你的依赖配置，只保留SpringBoot官方的starter依赖，让它帮你管理兼容的版本：

• Maven示例（pom.xml）：

  <dependencies>
      <dependency>
          <groupId>org.springframework.boot</groupId>
          <artifactId>spring-boot-starter-data-jpa</artifactId>
      </dependency>
      <dependency>
          <groupId>com.h2database</groupId>
          <artifactId>h2</artifactId>
          <scope>runtime</scope>
      </dependency>
  </dependencies>
  

  不要手动添加hibernate-core这类单独依赖，避免版本冲突。

4. Hibernate配置错误 #

如果你的application.properties/application.yml里配置了错误的属性访问模式，也会导致Hibernate无法访问私有字段。

解决办法：
检查配置文件，确保没有禁用字段访问的配置，必要时明确指定访问模式：

# 明确指定Hibernate直接访问字段
hibernate.property_access_mode=FIELD

完成以上调整后，重启SpringBoot应用，再执行CRUD操作应该就能正常运行了。

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