使用@Filter和@FilterDef为@Subselect实体添加参数失败

你遇到的过滤器不生效问题，核心原因是**@Filter的condition中引用了@Subselect子查询内部的表别名t2**。Hibernate将@Subselect定义的实体视为一个虚拟视图，外部查询无法识别子查询内的表别名，导致过滤器生成的WHERE子句无法关联到正确的字段，最终不生效。

方案一：将过滤条件整合到@Subselect的SQL中 #

直接在子查询SQL里加入过滤逻辑，通过@Filter传递参数绑定到SQL的占位符上，这是最直接有效的方式：

修改实体代码：

@Entity
@Immutable
@Subselect("select t2.object_id as objectId, count(*) as count\n" + 
           "\tFROM table1 t1\n" + 
           "\tINNER JOIN table2 t2 on t1.primary_id = t2.token_id\n" + 
           "\tWHERE t2.object_type = :objectTypeIdStr\n" + 
           "\tGROUP BY t2.object_id")
@FilterDef(
    name = "objectTypeIdStrFilter",
    parameters = @ParamDef(name = "objectTypeIdStr", type = "int")
)
@Filter(
    name = "objectTypeIdStrFilter",
    condition = "1=1" // 仅用于触发参数绑定，无实际过滤逻辑
)
public class ObjectCountView {
    @Id
    Integer objectId;

    @Column
    Integer count;
}

启用过滤器的代码保持不变，此时参数会直接传递到@Subselect的SQL中，实现对table2.object_type的过滤。

方案二：调整查询逻辑（仅当视图包含过滤字段时可用） #

如果你的视图返回了object_type字段（当前代码未返回），可以将@Filter的condition改为引用视图的字段（而非子查询内的表别名），例如：

@Filter(
    name = "objectTypeIdStrFilter",
    condition = "object_type = :objectTypeIdStr"
)

但当前你的视图只返回objectId和count，所以此方案不适用，仅作扩展参考。

• 确保过滤器启用时机：必须在创建Query之前启用过滤器，你的代码顺序是正确的，但如果是通过CriteriaQuery关联查询其他实体，需确保ObjectCountView的过滤器被正确应用。
• 参数类型匹配：@ParamDef的type需与实际参数类型一致，这里int对应Integer是没问题的。
• @Immutable实体限制：@Immutable实体不支持修改操作，但过滤器的参数绑定不受影响。

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