如何解决Hibernate中JPQL更新查询出现的‘Column 'is_deleted' in field list is ambiguous’错误

我来帮你解决这个问题！首先先明确两个核心点：

问题原因 #

是的，这是Hibernate在处理涉及关联实体的非标准JPQL UPDATE查询时的已知行为（或者说限制）：

1. JPQL的官方规范中，UPDATE语句是不支持直接使用JOIN的，Hibernate是提供了非标准的扩展支持来允许这种写法；
2. 当Hibernate处理这种扩展的JOIN式UPDATE时，在生成SQL的SET子句时，不会自动给列名加上主实体对应的表别名，而如果关联的实体恰好有同名属性（比如你的is_deleted），就会导致SQL中的列名歧义。

解决方案（无需原生SQL） #

下面给你两种可靠的解决办法，都不需要切换到原生SQL：

方案1：改用子查询替代JOIN（推荐，符合JPQL规范） #

把原来依赖JOIN的条件改成EXISTS子查询的形式，这是JPQL标准支持的语法，Hibernate对标准语法的处理会更完善，能正确生成带表别名的SQL：

@Modifying
@Query("UPDATE ActivityEnvironmentRelation aer "
       + "SET aer.isDeleted = 1, aer.updatedBy = :updatedBy "
       + "WHERE EXISTS ("
       + "    SELECT 1 FROM Activity a "
       + "    WHERE a.objectId = aer.activity.objectId "
       + "    AND a.project.objectId = :projectId"
       + ")")
void deleteActivityEnvironments(@Param("projectId") Long projectId, @Param("updatedBy") User updatedBy);

这种写法生成的SQL会是类似这样的：

UPDATE activity_environment aer1_0 
SET aer1_0.is_deleted = 1, aer1_0.updated_by = ? 
WHERE EXISTS (
    SELECT 1 FROM activity a1_0 
    WHERE a1_0.object_id = aer1_0.activity_id 
    AND a1_0.project_id = ?
)

可以看到，SET子句中的列都带上了主表的别名，彻底解决了歧义问题。

方案2：升级Hibernate版本 #

如果你的项目使用的是较旧的Hibernate版本（比如5.x早期版本），尝试升级到最新的稳定版（比如Hibernate 6.x系列）。新版本的Hibernate对JPQL扩展语法的处理有不少优化，可能已经修复了这种JOIN式UPDATE中SET子句别名缺失的问题。

备选方案：调整实体映射（不推荐，除非必要） #

如果上面的方法都不适用，你可以考虑修改实体的列名映射，让两个实体的is_deleted属性对应数据库中不同的列名（比如给Activity的isDeleted映射成activity_is_deleted），但这种方法需要修改数据库结构或实体映射，成本较高，所以仅作为最后备选。

总结 #

最推荐的是方案1，既符合JPQL的标准规范，又能完美解决列名歧义问题，同时不需要修改数据库或依赖原生SQL。

备注：内容来源于stack exchange，提问作者Jeswin George