如何在pg-promise中为连接设置search_path（默认schema）？

我之前也碰到过类似的坑，连接字符串加searchpath有时候会因为连接池复用的问题不生效，或者是写法没到位。下面给你两种靠谱的解决方案：

方法一：利用pg-promise的连接初始化钩子（推荐） #

这种方法能确保每个新建立的连接都会自动设置默认schema，完美适配连接池的场景：

const pgp = require('pg-promise')();

const connectionString = 'postgresql://your_user:your_pass@localhost:5432/your_db';

// 创建数据库实例时，通过connect钩子统一设置默认schema
const db = pgp({
  connectionString,
  async connect(client, dc, useCount) {
    // 用参数化查询避免SQL注入风险
    await client.query('SET search_path TO $1', ['your_target_schema']);
    // 如果需要同时设置多个schema，用逗号分隔即可：['schema1,schema2']
  }
});

这个connect函数会在每次新连接被创建并加入连接池时执行，不管后续怎么复用连接，schema的设置都会一直有效。

方法二：修正连接字符串的写法 #

如果更偏好通过连接字符串来设置，要确保格式完全正确，并且记得重启应用让连接池重新加载连接（旧连接的schema设置不会自动更新）：

// 单个schema的正确写法
const connectionString = 'postgresql://your_user:your_pass@localhost:5432/your_db?search_path=your_target_schema';
// 多个schema用逗号分隔：?search_path=public,your_target_schema

const db = pgp(connectionString);

为什么你之前的方法没生效？ #

你尝试的database.none('SET search_path TO ${schema}', { schema: ... })其实是有效的，但它只对当前正在使用的连接生效。如果pg-promise启用了连接池，后续获取的新连接不会继承这个设置，所以需要每次使用连接都执行一遍，远不如方法一的钩子省心。

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