使用JDBC与PostgreSQL时OFFSET N FETCH FIRST M ROWS语句失效问题

首先明确：PostgreSQL 完全支持 FETCH FIRST N ROWS ONLY 语法（这是SQL:2008标准的分页写法，和PostgreSQL原生的LIMIT等价），你的问题不是JDBC不支持这个语法，而是大概率出在这几个细节上：

可能的问题原因及解决方案 #

1. JDBC驱动版本过低 #

较老的pgJDBC驱动版本（比如42.1.x及更早）可能对FETCH FIRST语法的参数绑定处理存在兼容问题。建议你升级到最新的pgJDBC驱动（当前稳定版是42.6.x），新版本对标准SQL语法的支持更完善。

2. 参数位置绑定错误 #

你的报错提示syntax error at or near "$2"，说明第二个参数的位置可能有误。检查Queries.PAGING_ENDING_STATEMENT_OFFSET_ARGUMENT_POSITION和Queries.PAGING_ENDING_STATEMENT_LIMIT_ARGUMENT_POSITION的值：

• 拼接后的语句是OFFSET ? ROWS FETCH FIRST ? ROWS ONLY，第一个?对应offset（位置1），第二个?对应limit（位置2）
• 如果你的常量定义的位置不是1和2，就会导致参数绑定错位，触发语法错误

3. SQL拼接时缺少空格 #

虽然你说selectStatement.toString()显示语句正确，但还是要确认Queries.SELECT_SQL的结尾是否有空格。如果SELECT语句的最后没有空格，拼接后会变成：

SELECT columns FROM ... JOIN TableToJoin4OFFSET ? ROWS ...

这种情况下，TableToJoin4OFFSET会被识别为一个无效的表名，直接触发语法错误。确保SELECT_SQL的结尾有一个空格，再拼接分页语句。

正确的示例代码 #

这里给出一个验证过的可行示例：

// 确保SELECT语句结尾有空格
private static final String SELECT_SQL = "SELECT columns FROM your_table " +
        "LEFT JOIN table_join1 ON your_table.id = table_join1.table_id " +
        "LEFT JOIN table_join2 ON your_table.id = table_join2.table_id " +
        "LEFT JOIN table_join3 ON your_table.id = table_join3.table_id " +
        "JOIN table_join4 ON your_table.id = table_join4.table_id ";

private static final String PAGING_SQL = "OFFSET ? ROWS FETCH FIRST ? ROWS ONLY";

public void fetchData(int offset, int limit) throws SQLException {
    try (Connection connection = getYourConnection();
         PreparedStatement stmt = connection.prepareStatement(SELECT_SQL + PAGING_SQL)) {
        stmt.setInt(1, offset);
        stmt.setInt(2, limit);
        try (ResultSet rs = stmt.executeQuery()) {
            // 处理结果集
            while (rs.next()) {
                // 读取数据
            }
        }
    }
}

关于文档的说明 #

PostgreSQL官方文档中，FETCH FIRST ... ONLY的说明可以在SELECT语句的语法章节找到（而不是单独的Offset/Limit小节），它是标准SQL的分页写法，PostgreSQL 9.5及以上版本都支持。你在pgAdmin中能正常执行，说明你的PostgreSQL版本是支持的，问题还是出在JDBC端的配置或代码细节上。

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