如何将JPA/Hibernate实体字段设置为真正的只写模式

首先纠正一个常见误区：普通列并非无法实现懒加载，之前单独加LAZY注解不生效是缺少必要的配置，以下方案均不需要拆分表、也不需要重构整个仓储层。

方案1：开启Hibernate字节码增强，实现普通列原生懒加载（侵入性最低） #

这是最符合Hibernate设计逻辑的方案，不需要修改任何现有查询逻辑：

1. 给大体积jsonb字段添加基础懒加载注解

   @Basic(fetch = FetchType.LAZY)
   @Column(name = "your_large_jsonb_col", columnDefinition = "jsonb")
   private String yourLargeJsonbCol;
   

2. 配置Hibernate字节码增强插件，以Maven环境为例，在pom.xml中加入构建插件即可：

   <plugin>
       <groupId>org.hibernate.orm.tooling</groupId>
       <artifactId>hibernate-enhance-maven-plugin</artifactId>
       <version>${项目当前使用的hibernate版本}</version>
       <executions>
           <execution>
               <goals>
                   <goal>enhance</goal>
               </goals>
               <configuration>
                   <enableLazyInitialization>true</enableLazyInitialization>
               </configuration>
           </execution>
       </executions>
   </plugin>
   

配置完成后重启服务，开启SQL日志可以验证：普通查询场景下生成的SELECT语句不会包含该大字段，只有主动调用该字段的getter方法时，Hibernate才会发起二次查询加载字段内容，从根源避免大字段被默认加载进内存触发OOM。

方案2：@Formula注解屏蔽字段查询（零插件依赖，适合极少读大字段的场景） #

如果不想引入字节码增强插件，可以用Hibernate的@Formula注解欺骗框架，让查询时直接跳过原表大字段：

@Formula("(null::jsonb)")
@Column(name = "your_large_jsonb_col", columnDefinition = "jsonb")
private String yourLargeJsonbCol;

该配置下Hibernate生成普通查询语句时，不会读取原表的your_large_jsonb_col列，只会返回null作为字段值。

注意：该方案会影响该字段的读取逻辑，如果业务中存在少量需要读取该字段的场景，单独写自定义查询语句映射即可，写入逻辑不受注解影响。

方案3：投影查询指定返回字段（无版本兼容问题，最稳妥） #

如果受限于Hibernate版本无法使用前两个方案，直接用JPA投影机制指定查询字段即可，不需要重构仓储层：

1. 定义不含大字段的投影接口

   public interface BaseEntityProjection {
       Long getId();
       String getNormalField1();
       // 所有需要查询的普通字段在这里定义getter，不要添加大jsonb字段的对应方法
   }
   

2. 在Repository中编写返回投影类型的查询方法

   List<BaseEntityProjection> findAllBy();
   Optional<BaseEntityProjection> findBaseInfoById(Long id);
   

Hibernate会根据投影接口的方法生成对应SELECT语句，只会查询声明过的字段，完全不会读取大体积jsonb列。

• 给字段设置空setter、删除setter：如果JPA实体是字段访问模式（@Id注解标记在字段而非getter方法上），Hibernate会直接通过反射给字段赋值，完全不经过setter方法，修改setter不会对字段加载产生任何影响。
• 仅给普通列标记LAZY：Hibernate默认的动态代理机制仅支持关联实体（@OneToOne/@OneToMany等）的懒加载，普通列的懒加载拦截必须依赖字节码增强修改类字节码实现，单独加注解不会生效。

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