PostgreSQL / 系统课时

把租户上下文绑定到事务边界

把租户上下文绑定到事务边界

连接池会反复复用同一条数据库会话,因此把 tenant_id 设置成会话级状态会留下串租户风险。更稳妥的做法是:借出连接后先开启事务,用事务级配置写入租户上下文,再完成本次全部读写,最后提交或回滚。事务结束时上下文随数据库事务一起失效。

学习目标

  • 使用事务级配置向 PostgreSQL 注入当前租户标识
  • 保证租户读取、写入、提交或回滚始终使用同一物理连接
  • 处理异常、重试和连接归还时的上下文清理问题

事务级上下文为什么适合连接池

SET LOCAL,或等价的 set_config(name, value, true),只在当前事务内生效。事务 COMMIT 或 ROLLBACK 后,这个局部值会撤销,因此连接被归还到池中时不会继续携带本次请求设置的租户值。应用使用参数绑定时,set_config 比拼接 SET LOCAL app.tenant_id = '...' 更方便。

危险模式是先执行会话级 SET app.tenant_id = ...,再依赖业务代码最后手工 RESET。只要某条异常路径漏掉清理,下一次借到同一连接的请求就可能继承旧租户值。事务级状态把清理责任交给 PostgreSQL 的事务生命周期,故障面更小。

连接池中租户上下文绑定事务的时序

数据库侧让缺失上下文默认拒绝

RLS 策略应同时约束可见行和可写入行。下面的表达式用事务中的 app.tenant_id 与数据行的 tenant_id 比较;上下文不存在或为空时,表达式得到 NULL,不会放行任何行。策略 DDL 是片段示例,假设 app.invoice 已存在且包含 tenant_id uuid NOT NULL。

sql
ALTER TABLE app.invoice ENABLE ROW LEVEL SECURITY;

CREATE POLICY invoice_tenant_scope ON app.invoice
USING (
    tenant_id = NULLIF(current_setting('app.tenant_id', true), '')::uuid
)
WITH CHECK (
    tenant_id = NULLIF(current_setting('app.tenant_id', true), '')::uuid
);

预期结果:

text
ALTER TABLE
CREATE POLICY

再用一条干净连接验证事务级上下文的生命周期:

sql
BEGIN;
SELECT set_config(
    'app.tenant_id',
    '11111111-1111-1111-1111-111111111111',
    true
);

SELECT current_setting('app.tenant_id') AS tenant_inside_tx;
COMMIT;

SELECT
    NULLIF(current_setting('app.tenant_id', true), '') IS NULL
    AS context_cleared_after_commit;

在一条没有遗留会话级 app.tenant_id 的连接上,预期输出为:

text
BEGIN
              set_config
--------------------------------------
 11111111-1111-1111-1111-111111111111
(1 row)

           tenant_inside_tx
--------------------------------------
 11111111-1111-1111-1111-111111111111
(1 row)

COMMIT
 context_cleared_after_commit
------------------------------
 t
(1 row)

如果最后一项得到 f,说明该会话还有更早设置的会话级值。不要在正常请求路径同时混用会话级 SET 与事务级配置;应先清理旧实现,再把租户状态统一收敛到事务内。

应用代码把上下文放进同一事务

下面是 Node.js pg 连接池的片段示例,依赖已经创建好的 Pool 和业务表。关键点不是具体框架,而是上下文、业务 SQL 和结束事务必须在同一个 client 上执行。

javascript
async function withTenantTransaction(pool, tenantId, work) {
  const client = await pool.connect();

  try {
    await client.query('BEGIN');

    // true 表示事务级设置;租户值使用参数绑定,不拼接进 SQL。
    await client.query(
      "SELECT set_config('app.tenant_id', $1, true)",
      [tenantId]
    );

    // 所有受 RLS 保护的读写都必须复用这个事务连接。
    const result = await work(client);

    await client.query('COMMIT');
    return result;
  } catch (error) {
    await client.query('ROLLBACK');
    throw error;
  } finally {
    client.release();
  }
}

这段代码的生效行为是:work 只能在当前事务连接上执行租户 SQL;成功时 COMMIT 撤销事务级上下文,失败时 ROLLBACK 同样撤销它,之后连接才归还连接池。验证时可在 work 内查询 current_setting('app.tenant_id'),并确认其值等于本次请求的租户 ID。

失败、重试与连接归还

租户上下文要在 BEGIN 之后、第一条租户敏感 SQL 之前注入。不能先通过普通池查询执行一条 RLS SQL,再开始事务;也不能在事务回调里临时换用另一个池连接,否则 RLS 看到的上下文和业务 SQL 可能不在同一会话。

发生 SQL 异常时先回滚,再归还连接。若业务对死锁或序列化失败进行整笔事务重试,每次重试都要重新 BEGIN、重新注入同一个可信的 tenant_id,再重新执行读写,不能假设上一次事务的局部配置还存在。

租户 ID 还必须来自已经完成认证和授权的服务端上下文,而不是直接相信请求体中的任意字段。把可信租户身份、事务级数据库上下文、RLS 策略和连接池生命周期连成一条链,才能让连接复用保持高效的同时,不把租户隔离交给人工清理。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

把租户上下文绑定到事务边界

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通