PostgreSQL / 技术文章
PostgreSQL RLS 策略到底怎么生效
这篇文章解决一个常见但容易混淆的问题:RLS 到底处在 PostgreSQL 权限链的哪一层、哪些策略会参与一条 SQL、多个策略怎样合并,以及为什么同一策略在普通角色、表所有者和 BYPASSRLS 角色下会得到完全不同的结果。适合已经会配置基础 RLS 的开发和运维人员;读完后,你可以根据命令类型、执行身份和策略集合,推导一条语句最终能读到或写入哪些行。
RLS 是对象权限之后的行级约束
RLS 不能替代 GRANT。访问一张表时,调用者仍然必须具备 schema 与表级权限;这些权限回答“能不能执行这类命令”,RLS 再回答“这类命令可以作用到哪些行”。
GRANT USAGE ON SCHEMA app TO app_runtime;
GRANT SELECT, INSERT, UPDATE, DELETE ON app.orders TO app_runtime;
ALTER TABLE app.orders ENABLE ROW LEVEL SECURITY;因此,GRANT SELECT 不会让角色绕过 RLS,策略也不会自动补齐缺失的 SELECT 权限。对象权限不足时通常得到 permission denied;对象权限足够但没有行通过策略时,SELECT 更常表现为零行。
还要区分“RLS 已启用”和“当前角色实际受 RLS 约束”。超级用户、带 BYPASSRLS 属性的角色,以及默认情况下的表所有者,都可能在进入策略求值前就绕过这层行级约束。
PostgreSQL 先确定这条语句适用哪些策略
一张表可以有多条策略,但并不是所有策略都会参与每一条 SQL。PostgreSQL 会根据策略的命令范围和角色范围筛选适用策略;TO 指定的角色也包含其成员关系,PUBLIC 则匹配所有角色。
CREATE POLICY tenant_read
ON app.orders
FOR SELECT
TO app_runtime
USING (tenant_id = current_setting('app.tenant_id')::bigint);
CREATE POLICY tenant_write
ON app.orders
FOR UPDATE
TO app_runtime
USING (tenant_id = current_setting('app.tenant_id')::bigint)
WITH CHECK (tenant_id = current_setting('app.tenant_id')::bigint);
CREATE POLICY auditor_read
ON app.orders
FOR SELECT
TO auditor
USING (true);假设 app_runtime 不是 auditor 的成员,当它执行普通 SELECT 时,tenant_read 适用,tenant_write 因命令不匹配而不参与,auditor_read 因角色不匹配也不参与。FOR ALL 可以覆盖多种命令,但仍然要满足角色范围。
如果表已启用 RLS,而当前操作没有任何能够建立允许范围的适用策略,结果是默认拒绝,而不是自动放行。读取时通常表现为零行;需要写入新行时则可能收到 row-level security policy 相关错误。
策略表达式会变成查询的一部分,不是按顺序执行的钩子
RLS 策略不是触发器,也不是“先跑策略 A,再跑策略 B”的过程式代码。策略表达式会作为行级安全条件参与查询重写和计划,最终与用户 SQL 的条件共同决定哪些元组可继续向下执行。
从语义上看,RLS 条件应当先保护行,再让用户条件处理已允许的行;优化器可以对被标记为 LEAKPROOF 的函数做例外重排,所以不要依赖普通 SQL 谓词与策略谓词之间的物理执行先后顺序来构造安全边界。
策略表达式本身也不会自动获得表所有者权限。它在执行时仍处于调用者的权限上下文;如果策略直接查询另一张表,调用者通常需要相应访问权限。若通过 SECURITY DEFINER 函数代查,则权限边界转移到了该函数所有者,这已经是另一条需要单独审计的特权路径。
CREATE POLICY member_only
ON app.orders
FOR SELECT
TO app_runtime
USING (
EXISTS (
SELECT 1
FROM app.tenant_membership m
WHERE m.tenant_id = orders.tenant_id
AND m.user_name = current_user
)
);如果 app_runtime 无权读取 app.tenant_membership,这类策略可能直接报权限错误,而不是把结果静默变成空集。
PERMISSIVE 与 RESTRICTIVE 决定最终布尔公式
默认策略是 PERMISSIVE。同一操作下,适用的 permissive 策略用 OR 合并;适用的 restrictive 策略用 AND 收紧结果。限制性策略不能单独建立允许集合,因此至少需要一条适用的 permissive 策略先放行候选行。
设有两个 permissive 条件 、 和两个 restrictive 条件 、,最终允许条件可以理解为:
例如:
CREATE POLICY tenant_rows
ON app.orders
AS PERMISSIVE
FOR SELECT
TO app_runtime
USING (tenant_id = current_setting('app.tenant_id')::bigint);
CREATE POLICY shared_rows
ON app.orders
AS PERMISSIVE
FOR SELECT
TO app_runtime
USING (is_shared);
CREATE POLICY active_only
ON app.orders
AS RESTRICTIVE
FOR SELECT
TO app_runtime
USING (status = 'active');这三条策略表达的是“租户行或共享行,并且状态必须为 active”。创建顺序不决定求值语义,策略名也没有优先级含义;真正要看的是适用范围、策略类型和布尔组合。
USING 管旧行,WITH CHECK 管新行
RLS 写入语义最容易在 UPDATE 上混淆。USING 约束已经存在的行,决定哪些旧行可以被 SELECT、UPDATE 或 DELETE 看到和命中;WITH CHECK 约束即将写入的新行,决定 INSERT 新行或 UPDATE 后的新版本是否允许存在。
CREATE POLICY tenant_update
ON app.orders
FOR UPDATE
TO app_runtime
USING (tenant_id = current_setting('app.tenant_id')::bigint)
WITH CHECK (tenant_id = current_setting('app.tenant_id')::bigint);当前租户为 10 时,下面的语句可能先通过旧行的 USING,却在新行的 WITH CHECK 阶段被拒绝:
UPDATE app.orders
SET tenant_id = 20
WHERE id = 42;可以用下表理解核心分工:
| 操作 | 旧行是否可见或可操作 | 新行是否合法 |
|---|---|---|
| SELECT | USING |
不适用 |
| INSERT | 不适用 | WITH CHECK |
| UPDATE | USING |
WITH CHECK |
| DELETE | USING |
不适用 |
实际 UPDATE 还可能因为 WHERE、RETURNING、SET 右侧表达式等需要读取列,从而同时要求 SELECT 权限,并叠加相应的 SELECT/ALL 策略;所以“有 UPDATE 策略”不等于“UPDATE 一定能看到待更新行”。
如果某条同时支持读写语义的策略省略 WITH CHECK,PostgreSQL 会按策略定义规则使用对应的 USING 表达式作为检查条件。为了审计清晰,生产策略通常值得显式写出两者,而不是让维护者靠默认规则猜写入边界。
执行身份和绕过属性决定策略是否真正生效
RLS 不是绑定到“最初是谁连上数据库”的静态规则,而是受当前有效执行身份影响。SET ROLE 会改变 current_user,策略的 TO 匹配、对象权限以及许多权限判断也随之改变;session_user 仍表示最初建立会话的身份。
SELECT session_user, current_user;
SET ROLE app_runtime;
SELECT session_user, current_user;典型结果类似:
session_user | current_user
--------------+--------------
app_login | app_login
session_user | current_user
--------------+--------------
app_login | app_runtime绕过边界要单独核对:超级用户始终绕过 RLS;带 BYPASSRLS 的角色绕过 RLS;表所有者默认绕过自己表上的 RLS,除非对该表启用 FORCE ROW LEVEL SECURITY。
ALTER TABLE app.orders FORCE ROW LEVEL SECURITY;
SELECT rolname, rolsuper, rolbypassrls
FROM pg_roles
WHERE rolname IN ('app_runtime', 'app_owner');FORCE ROW LEVEL SECURITY 主要是把表所有者纳入策略约束,它不会取消超级用户或 BYPASSRLS 角色的绕过能力。
用固定顺序推导一条 SQL 的最终边界
遇到“为什么能看到这行”或“为什么 UPDATE 被拒绝”时,不要只盯着某一条策略文本,可以按下面的顺序还原:
current_user是谁,是否属于超级用户、BYPASSRLS或表所有者绕过场景。- 该 SQL 需要哪些 schema、表和列级对象权限,调用者是否具备。
- 操作类型是什么,哪些策略的角色范围与命令范围会参与。
- permissive 策略怎样 OR,restrictive 策略怎样 AND,是否存在至少一条适用的 permissive 策略。
- 旧行经过哪些
USING条件,新行经过哪些WITH CHECK条件。 - 策略依赖的上下文值和外部对象权限是否正确,例如
current_setting('app.tenant_id')是否真是当前事务的租户值。
系统视图可以把策略定义直接还原出来:
SELECT schemaname,
tablename,
policyname,
permissive,
roles,
cmd,
qual,
with_check
FROM pg_policies
WHERE schemaname = 'app'
AND tablename = 'orders'
ORDER BY policyname;再用最小查询确认身份与租户上下文:
SELECT session_user,
current_user,
current_setting('app.tenant_id', true) AS tenant_id;
SELECT id, tenant_id, status
FROM app.orders
ORDER BY id;当你能按“绕过边界与执行身份 → 对象权限 → 适用策略 → permissive/restrictive 合并 → USING/WITH CHECK”解释结果时,RLS 就不再是隐藏在数据库里的黑盒过滤器,而是一套可以逐项推导、验证和审计的权限判定机制。