Postgres.js 中动态 SQL 查询的优雅实现方案

2025-05-28 15:32:53作者：薛曦旖Francesca

Postgres.js 是一个流行的 Node.js PostgreSQL 客户端库，它提供了强大的 SQL 查询功能。在实际开发中，我们经常需要构建动态 SQL 查询，这在使用模板字符串语法时可能会遇到可读性差的问题。本文将探讨几种在 Postgres.js 中实现动态查询的优雅方案。

模板字符串语法的局限性

Postgres.js 默认使用 ES6 模板字符串语法来构建 SQL 查询，例如：

const result = await sql`SELECT * FROM users WHERE id = ${id}`;

这种语法对于简单查询非常直观，但当我们需要构建复杂的动态查询时，代码会变得难以维护。特别是当需要动态添加多个条件时，开发者往往需要使用大量三元运算符，导致代码可读性急剧下降。

使用 sql.unsafe 方法

Postgres.js 提供了 sql.unsafe 方法来解决这个问题。这个方法允许我们使用传统的参数化查询方式：

const query = 'SELECT * FROM users WHERE name = $1 AND age > $2';
const params = ['Alice', 25];
const result = await sql.unsafe(query, params);

这种方法更接近其他数据库客户端库的使用方式，对于从其他库迁移过来的开发者会更加熟悉。需要注意的是，默认情况下 sql.unsafe 不会使用预处理语句，但我们可以通过选项显式启用：

const result = await sql.unsafe(query, params, { prepare: true });

预处理语句的注意事项

预处理语句是数据库性能优化的重要手段。Postgres.js 会自动为静态结构的查询创建和使用预处理语句。当我们使用 sql.unsafe 时，默认情况下会禁用预处理语句，因为库无法确定查询结构是否稳定。

启用预处理语句后，数据库会缓存查询计划，对于重复执行的相同查询模式（只是参数不同）可以显著提高性能。但要注意，过度使用预处理语句可能会占用大量数据库内存，因此需要根据实际情况权衡。

动态条件构建技巧

在实际应用中，我们经常需要根据不同的条件动态构建 WHERE 子句。以下是几种推荐的做法：

使用数组过滤和连接：

const conditions = [];
const params = [];

if (name) {
  conditions.push('name = $' + (params.length + 1));
  params.push(name);
}

if (age) {
  conditions.push('age > $' + (params.length + 1));
  params.push(age);
}

const whereClause = conditions.length ? 'WHERE ' + conditions.join(' AND ') : '';
const query = `SELECT * FROM users ${whereClause}`;
const result = await sql.unsafe(query, params, { prepare: true });