Spring JPA自定义@Query查询抛出unexpected token: vz异常如何解决？

云上老周

2026-10-5

问题原因

该异常的直接原因是拼接JPQL查询字符串时，相邻的字符串片段之间没有预留空格，最终生成的查询语句存在语法错误。
你给出的代码拼接后实际生成的JPQL为：
select vz from VzClass vzjoin vz.PHClass phc on vz.ph = phc.idjoin phc.GFClass gf on phc.id = gf.phousejoin gf.PIClass pi on gf.pic = pi.idwhere vz.fi is not null and vz.ci is null and pi.prId in (:pIds)
可以看到vz和后面的join直接拼接成了非法标识符vzjoin，JPQL解析器无法识别该结构，因此抛出了unexpected token: vz的异常。

修复方案

你可以从以下两种方案中选择符合你开发环境的修复方式：

方案1：在每段字符串的末尾/开头补充空格，保证拼接后语法通顺，修改后的代码如下：

@Query("select vz from VzClass vz " +
            "join vz.PHClass phc on vz.ph = phc.id " +
            "join phc.GFClass gf on phc.id = gf.phouse " +
            "join gf.PIClass pi on gf.pic = pi.id " +
            "where vz.fi is not null and vz.ci is null and pi.prId in (:pIds)")
List<VzClass> getVzByPIids(@Param("pIds") List<String> plIds, Pageable pageable);

方案2：如果使用JDK 15及以上版本，可以直接用文本块编写JPQL，彻底避免空格拼接问题：

@Query("""
        select vz from VzClass vz
        join vz.PHClass phc on vz.ph = phc.id
        join phc.GFClass gf on phc.id = gf.phouse
        join gf.PIClass pi on gf.pic = pi.id
        where vz.fi is not null and vz.ci is null and pi.prId in (:pIds)
        """)
List<VzClass> getVzByPIids(@Param("pIds") List<String> plIds, Pageable pageable);