Spring Boot实体类@Transient final变量加getter后启动报错排查

这个报错是Hibernate JPA的属性访问规则和JavaBean规范冲突导致的：

• Hibernate处理实体类时，不会只看字段上的注解判断持久化属性：只要类中存在符合JavaBean规范的无参getter（方法名getXxx、无入参、带对应返回值），就会默认将其识别为需要持久化的实体属性。
• 你把@Transient加在了invisibleName字段上，这个注解仅在Hibernate使用字段访问策略时生效；一旦对应的无参getter存在，Hibernate切换到属性访问逻辑识别到这个属性，会尝试找对应的字段映射、可写入的setter方法，而你的字段是final类型、没有对应setter，Hibernate无法完成属性映射构造，就会抛出你看到的SingleTableEntityPersister初始化失败异常。
• 你给getter加无意义参数后不报错，本质是破坏了JavaBean getter的方法签名规则，Hibernate不再把这个方法识别为属性getter，自然不会触发映射逻辑。
• 额外提一句：你的代码里@Id同时标注在deviceId字段和getDeviceId()方法上，会进一步干扰Hibernate对访问策略的判断，建议后续统一JPA注解的标注位置，要么全放在字段上，要么全放在getter方法上。

任选一种符合你业务需求的规范写法即可，不需要保留无意义的方法参数：

• 最优方案：将固定值定义为静态常量
  你这个字段是固定写死的常量值，本身和实体实例状态无关，按Java编码规范本就应该定义为静态常量，JPA会直接忽略类的静态字段，不会做任何持久化映射，连@Transient注解都不需要添加：

  private static final String INVISIBLE_NAME = "Jwfqp4bbqiFzRLcFVV3qf";
  
  // 按需保留getter即可，不会被Hibernate识别为持久化属性
  public static String getInvisibleName() {
      return INVISIBLE_NAME;
  }
  

• 实例字段场景：将@Transient移到getter方法上
  如果你确实需要这个字段是实例级别的非持久化属性，把@Transient注解从字段移到对应的getter方法上，同时记得把getDeviceId()上多余的@Id删掉，统一在字段上标注JPA注解即可：

  // 移除字段上的@Transient
  private final String invisibleName = "Jwfqp4bbqiFzRLcFVV3qf";
  
  // 在getter上添加@Transient
  @Transient
  public String getInvisibleName(){
      return invisibleName;
  }
  

• 全局指定字段访问策略
  在实体类上添加@Access(AccessType.FIELD)注解，强制Hibernate只通过字段扫描识别持久化属性，这种情况下字段上的@Transient会正常生效，类中的getter方法不会被自动识别为持久化属性：

  @ApiModel(description = "This class represents a device with its basic information.")
  @Entity
  @Table(name = "device")
  @Access(AccessType.FIELD) // 强制使用字段访问策略
  public class Device {
      // 原有字段上的@Transient无需调整
  }
  

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