Spring JPA执行PostgreSQL原生查询时遇冒号语法错误求助

这个错误的核心原因是Spring Data JPA的查询解析器会把SQL中的:识别为参数占位符，但你的SQL中该位置的:是PostgreSQL原生语法的一部分（比如数组切片arr[1:3]、URL字符串'https://xxx'等），或者存在参数占位符的语法错误。以下是具体解决办法：

1. 转义原生SQL中的冒号 #

如果SQL中的:是PostgreSQL语法需要的（非参数占位符），在SQL字符串中用\\:替换原有的:，让Spring Data JPA解析器将其视为普通字符传递给数据库。

示例：

• 原SQL（数组切片）：

SELECT arr[1:3] FROM test_table

• 修改后：

SELECT arr[1\\:3] FROM test_table

• 原SQL（含URL字符串）：

SELECT 'https://example.com/api' AS api_url FROM test_table

• 修改后：

SELECT 'https\\://example.com/api' AS api_url FROM test_table

2. 绕过Spring Data JPA的参数解析，直接用EntityManager执行 #

如果不想修改SQL字符串，可以通过EntityManager直接创建原生查询，这种方式不会触发Spring对:的参数解析逻辑：

import javax.persistence.EntityManager;
import javax.persistence.Query;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Repository;
import java.util.List;

@Repository
public class CustomRepository {

    @Autowired
    private EntityManager entityManager;

    public List<Object[]> runNativeQuery() {
        String sql = "你的原生SQL语句（保留原始冒号）";
        Query query = entityManager.createNativeQuery(sql);
        // 若需传递参数，使用索引占位符并设置参数
        // query.setParameter(1, "paramValue");
        return query.getResultList();
    }
}

3. 检查并修正参数占位符错误 #

如果你的SQL确实需要使用参数，检查是否存在占位符语法错误：

• 确保每个命名占位符（如:userId）都有对应的方法参数，并用@Param注解标注：

import org.springframework.data.jpa.repository.Query;
import org.springframework.data.repository.query.Param;
import java.util.List;

public interface UserRepository extends JpaRepository<User, Long> {

    @Query(nativeQuery = true, value = "SELECT * FROM user WHERE id = :userId AND name = :userName")
    List<User> findByIdAndName(@Param("userId") Long userId, @Param("userName") String userName);
}

• 避免出现无参数名的:（如WHERE name = :），这类错误会直接导致语法解析失败。

验证步骤 #

1. 定位报错位置（1936位）的:，确认其用途是原生SQL语法还是参数占位符；
2. 根据场景选择上述对应方案修改代码；
3. 重新执行查询，验证错误是否解决。

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