如何获取带参数的PostgreSQL查询执行计划？

错误原因 #

你遇到的ERROR: there is no parameter $1报错，核心是两个问题：

1. PostgreSQL的EXECUTE语句不支持括号传递参数的语法（这是其他数据库如MySQL的写法），正确传递预定义查询参数的方式是EXECUTE ... USING子句。
2. JDBC的?占位符在错误的位置（括号内）无法被PostgreSQL正确解析，数据库会认为你要引用当前语句的$1参数，但该语句并未定义，因此报错。

解决方案 #

方案一：直接对原查询执行EXPLAIN（推荐）

无需提前创建预定义查询，直接将目标查询嵌入EXPLAIN语句中，用JDBC的?作为参数占位符，JDBC会自动完成参数绑定，既简洁又能获取真实参数对应的执行计划。

Connection conn = DriverManager.getConnection("...", "...", "...");

// 直接在EXPLAIN中使用原查询，通过?绑定参数
PreparedStatement ps = conn.prepareStatement(
  "explain (format json) select * from documents where content = ?");
ps.setString(1, "Very long content here...");
ResultSet rs = ps.executeQuery();

while (rs.next()) {
  System.out.println(rs.getString(1));
}

方案二：使用PREPARE + EXECUTE ... USING语法

如果业务必须使用预定义查询（PREPARE），则需要改用PostgreSQL标准的EXECUTE ... USING语法传递参数，JDBC的?占位符可以直接对应USING后的参数位置：

Connection conn = DriverManager.getConnection("...", "...", "...");

// 预定义查询语句
PreparedStatement ps1 = conn.prepareStatement(
  "prepare x as select * from documents where content = $1");
ps1.execute();

// 用EXECUTE ... USING绑定参数，获取执行计划
PreparedStatement ps2 = conn.prepareStatement(
  "explain (format json) execute x using ?");
ps2.setString(1, "Very long content here...");
ResultSet rs = ps2.executeQuery();

while (rs.next()) {
  System.out.println(rs.getString(1));
}

额外说明 #

• 硬编码参数能生效是因为直接将参数值嵌入了SQL语句，但这种方式存在SQL注入风险，且无法处理大内容参数或特殊数据类型（如浮点、二进制）。
• 用null替代?得到的执行计划无参考价值，因为PostgreSQL会针对null值生成特殊的执行逻辑，和真实参数的执行计划差异极大。

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