Spring Boot JPA原生查询SQL错误：PostgreSQL类型转换符(::)引发语法异常

这个坑我之前踩过！你遇到的错误核心原因是：JPA会把SQL语句中的冒号:默认识别为参数占位符，而PostgreSQL的::类型转换符刚好包含冒号，导致JPA误解析，抛出syntax error at or near ":"的异常。

为什么直接在PostgreSQL中运行正常？ #

因为PostgreSQL本身支持::作为类型转换语法，但JPA的SQL解析器不认识这种PostgreSQL专属语法，会把第一个:当成参数的开始，自然就报错了。你之前尝试用\转义的方式行不通，是因为Java字符串里的反斜杠本身需要转义（得写成\\），但即使这样，最终传到PostgreSQL的SQL会变成\::，这在PostgreSQL里是无效语法，所以编译和运行都会出问题。

两个可行的解决方案 #

1. 用标准SQL的CAST()函数替代::（推荐）

这是最稳妥的方案，CAST()是SQL标准语法，不仅能避开JPA的冒号解析问题，还能让查询更具数据库兼容性。把你的查询修改成这样：

WHERE year = CAST(extract(year FROM CURRENT_DATE - CAST('2 month' AS interval)) AS integer)
AND month = CAST(extract(month FROM CURRENT_DATE - CAST('2 month' AS interval)) AS integer)

这样修改后，JPA不会再把冒号当成参数占位符，PostgreSQL也能正常解析CAST()语法，完美解决冲突。

2. 强制JPA不解析冒号（不推荐，可读性差）

如果你非要保留PostgreSQL的::语法，可以通过Java字符串的转义，把::写成\\:\\:（因为Java里单个反斜杠需要转义为两个，最终传到数据库的是::）。比如你的Java代码里的查询字符串要写成：

@Query(value = "SELECT ... WHERE year = extract( year FROM CURRENT_DATE - '2 month'\\:\\:interval)\\:\\:int and month = extract( month FROM CURRENT_DATE - '2 month'\\:\\:interval)\\:\\:int", nativeQuery = true)

但这种方式可读性极差，而且容易出错，所以还是优先推荐用CAST()方案。

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