PostgreSQL执行SET绑定参数报错：syntax error at or near $1

问题原因 #

PostgreSQL的SET命令属于实用命令，这类命令不支持使用参数占位符（如$1或:variable）。JDBC驱动会将你代码中的绑定变量转换为$1，但PostgreSQL在SET语句的赋值位置无法识别该占位符，因此抛出语法错误。

而DBeaver能正常运行，是因为它在客户端就将占位符替换为实际值，并非通过PreparedStatement执行带参数的SET命令。

解决方案 #

方案1：直接拼接值（仅适用于可信输入） #

如果变量值是安全可信的（无SQL注入风险），可以直接将值拼入SQL语句：

String variableValue = "variableValue";
this.getSessionFactory().getCurrentSession()
    .createNativeQuery("SET app.variable = '" + variableValue + "'")
    .executeUpdate();

方案2：使用PL/pgSQL的DO块（安全支持绑定变量） #

通过PostgreSQL的DO块包裹SET命令，PL/pgSQL代码支持参数绑定，既安全又能使用变量：

this.getSessionFactory().getCurrentSession()
    .createNativeQuery("DO $$ BEGIN SET app.variable = :variable; END $$;")
    .setParameter("variable", "variableValue")
    .executeUpdate();

方案3：直接使用JDBC Statement #

绕过Hibernate的PreparedStatement机制，直接获取JDBC连接执行原生语句：

Session session = this.getSessionFactory().getCurrentSession();
Connection conn = session.doReturningWork(connection -> connection);
try (Statement stmt = conn.createStatement()) {
    stmt.execute("SET app.variable = 'variableValue'");
} catch (SQLException e) {
    // 处理异常逻辑
}

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