JPA非原生查询子查询参数被Spring误报异常问题求助

问题背景 #

我在运行一个返回自定义对象的JPA非原生查询时遇到了异常日志问题：
查询代码如下：

@Query("""
    SELECT
    new path.to.CustomObject(
        t,
        (select id from users where name = :param1),
        (select id from departments where name IN (:param2))
    )
    FROM timesheets t
    WHERE status = :param3
""")
Page<CustomObject> getAll(
    @Param("param1") String param1,
    @Param("param2") List<String> param2,
    @Param("param3") String param3,
    Pageable pageable
)

当使用默认分页（size=10，page=0）执行时，日志会打印：

o.s.d.j.r.q.QueryParameterSetter$ErrorHandling: Silently ignoring
java.lang.IllegalArgumentException: Could not locate named parameter [param1], expecting one of [param3]
java.lang.IllegalArgumentException: Could not locate named parameter [param2], expecting one of [param3]

但查询实际能正常运行并返回正确结果；使用更大分页尺寸（如size=30，page=0）时则无异常日志。

尝试在WHERE条件中添加恒成立语句：

[...]
FROM timesheets t
WHERE status = :param3
AND :param1 = :param1
AND :param2 = :param2

仅param2仍会触发异常（因其为List类型），需要找到办法避免这些不影响执行的“伪异常”日志。

可行解决方案 #

1. 手动指定count查询，覆盖自动生成逻辑 #

问题根源是Spring Data JPA处理分页时，会自动生成count查询计算总条数，但自动生成的count查询只会包含WHERE条件里的参数，忽略了SELECT子句中子查询的参数，导致参数绑定失败打日志。

手动指定count查询，确保其包含所有需要绑定的参数：

@Query(value = """
    SELECT
    new path.to.CustomObject(
        t,
        (select id from users where name = :param1),
        (select id from departments where name IN (:param2))
    )
    FROM timesheets t
    WHERE status = :param3
""",
countQuery = """
    SELECT COUNT(t)
    FROM timesheets t
    WHERE status = :param3
    AND EXISTS (SELECT 1 FROM users u WHERE u.name = :param1)
    AND EXISTS (SELECT 1 FROM departments d WHERE d.name IN (:param2))
""")
Page<CustomObject> getAll(
    @Param("param1") String param1,
    @Param("param2") List<String> param2,
    @Param("param3") String param3,
    Pageable pageable
)

这里通过EXISTS语句在count查询中引用param1和param2，让参数绑定逻辑能识别到这些参数，彻底解决日志问题。

2. 优化恒成立条件适配List类型 #

针对List类型的param2，直接使用:param2 = :param2会导致JPA无法处理，可改用基于List属性的恒成立判断：

[...]
FROM timesheets t
WHERE status = :param3
AND :param1 = :param1
AND SIZE(:param2) = SIZE(:param2)

SIZE(:param2) = SIZE(:param2)是恒成立的条件，同时能让JPA正确绑定List类型参数，消除对应的异常日志。

3. 调整日志级别，屏蔽指定类的日志输出 #

如果不想修改查询代码，可直接通过日志配置屏蔽该类的日志。以常用日志框架为例：

• Logback：在logback.xml中添加

<logger name="org.springframework.data.jpa.repository.query.QueryParameterSetter$ErrorHandling" level="OFF"/>

• Log4j2：在log4j2.xml中添加

<Logger name="org.springframework.data.jpa.repository.query.QueryParameterSetter$ErrorHandling" level="OFF"/>

将该类的日志级别设为OFF或ERROR，即可不再打印这些“伪异常”日志。

内容的提问来源于stack exchange，提问作者Marco Frag Delle Monache