JPA原生查询WHERE子句外传参报冒号附近语法错误解决方案

Spring Data JPA 原生查询的参数绑定逻辑，不会识别被单引号包裹的:参数名占位符。
你代码中写的'{:userUUID}'把:userUUID包裹在了单引号内部，JPA会把这部分整体识别为普通字符串字面量，不会将其替换为实际传入的UUID参数值，最终带冒号的原生字符串会被直接发送到数据库执行，数据库解析到未处理的冒号就会抛出语法错误。
额外注意：你查询中给count(ql.*)取的别名like是SQL保留关键字，就算解决了参数问题，也大概率会触发新的语法错误。

推荐使用性能更好、写法更稳妥的EXISTS子查询实现点赞状态判断，完全避开参数在字符串字面量中无法识别的问题，同时修正别名的关键字冲突：

@Query(value = "SELECT q.quote, q.author, q.display_at, count(ql.*) AS like_count, " +
        "EXISTS (SELECT 1 FROM quotes_likes ql_sub WHERE ql_sub.quote_uuid = q.uuid AND ql_sub.user_uuid = :userUUID) AS liked " +
        "FROM quotes q " +
        "LEFT JOIN quotes_likes ql ON ql.quote_uuid = q.uuid " +
        "WHERE q.display_at = :date " +
        "GROUP BY q.quote, q.author, q.display_at", nativeQuery = true)
Optional<QuoteOfTheDay> getQuoteOfTheDay(UUID userUUID, LocalDate date);

如果你一定要保留原有的数组重叠判断逻辑，注意不要用单引号包裹参数占位符，直接通过预编译参数绑定即可，修改对应SQL片段为：

(SELECT ARRAY[:userUUID]::uuid[] && ARRAY_AGG(ql.user_uuid)::uuid[]) AS liked

这种写法下JPA可以正常识别到独立的:userUUID占位符，会自动完成参数类型转换和绑定，不会出现语法错误。

• JPA原生查询使用预编译机制实现参数绑定，不是简单的字符串替换，不要手动给参数占位符加单引号，否则会导致占位符无法被识别。
• 定义列别名时避开SQL保留字，避免无意义的语法报错。
• 用EXISTS判断用户是否点过赞，不需要聚合当前语录下所有点赞用户的UUID，匹配到对应记录就会终止查询，性能远高于数组聚合后判断重叠的写法。

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