Node.js单线程环境下，使用node-postgres的Pool替代Client是否有用？

结论：生产环境REST API优先用连接池（Pool） #

先纠正你对Node.js单线程的误解：Node的事件循环是单线程，但异步IO操作（比如PostgreSQL查询）是由底层线程池处理的。当你的Express API同时收到多个请求时，每个请求都会发起异步DB查询，这些查询会在后台并行执行，但如果只用单个Client连接，所有查询都得排队等这个连接释放——因为一个PostgreSQL连接同一时间只能处理一个查询。举个例子：10个并发请求过来，单个连接得一个接一个处理，响应时间会是串行的总和；用连接池的话，比如池大小设为5，就能同时处理5个请求，剩下的5个排队，整体吞吐量提升好几倍。

关于预编译语句的误区 #

单个Client预编译语句确实能复用，但风险很高：

• 如果这个连接意外断开（比如DB重启、网络波动），所有预编译的语句都会失效，你得重新初始化，这会导致服务报错。
• 连接池也能复用预编译语句：你可以通过pool.on('connect')事件，在每个连接创建时预编译常用语句，连接池的连接是长期复用的，不会每次请求都新建，所以编译开销可以忽略。而且即使某个连接断了，池会自动新建连接并重新预编译，不影响其他请求。

两种方式的适用场景 #

• 用Client的情况：一次性脚本（比如数据迁移脚本、临时数据导出）、极低并发的测试项目，或者需要独占连接的特殊操作。
• 用Pool的情况：生产环境的REST API、任何有并发请求的服务——连接池会自动管理连接的创建、复用、销毁，稳定性和容错性远高于单个Client。

简单代码示例 #

连接池基本用法

const { Pool } = require('pg');

const pool = new Pool({
  user: 'your_user',
  host: 'your_host',
  database: 'your_db',
  password: 'your_pass',
  port: 5432,
  max: 10, // 连接池最大连接数，根据DB配置调整
  idleTimeoutMillis: 30000, // 连接闲置超时时间
});

// 在连接创建时预编译语句
pool.on('connect', async (client) => {
  await client.query('PREPARE get_user AS SELECT * FROM users WHERE id = $1');
});

// 处理API请求
app.get('/users/:id', async (req, res) => {
  const { id } = req.params;
  try {
    const result = await pool.query('EXECUTE get_user ($1)', [id]);
    res.json(result.rows[0]);
  } catch (err) {
    res.status(500).json({ error: err.message });
  }
});

单个Client的问题示例（不推荐生产用）

const { Client } = require('pg');

const client = new Client({ /* 配置 */ });
client.connect();

// 预编译语句
client.query('PREPARE get_user AS SELECT * FROM users WHERE id = $1');

app.get('/users/:id', async (req, res) => {
  const { id } = req.params;
  try {
    // 多个并发请求会排队等这个连接释放
    const result = await client.query('EXECUTE get_user ($1)', [id]);
    res.json(result.rows[0]);
  } catch (err) {
    res.status(500).json({ error: err.message });
    // 如果连接断了，得重新连接+预编译，处理起来很麻烦
    client.connect();
    client.query('PREPARE get_user AS SELECT * FROM users WHERE id = $1');
  }
});

内容的提问来源于stack exchange，提问作者Ahmet Yazıcı