PostgreSQL / 技术文章
PostgreSQL RLS 越权与误拦截怎么排查
当 PostgreSQL 多租户应用出现“看到了别的租户数据”“明明有数据却查不到”“INSERT/UPDATE 被策略拒绝”时,最难的往往不是写策略,而是判断问题究竟来自数据库身份、租户上下文、普通授权还是 RLS 求值。本篇面向应用工程师和 DBA,给出一条以证据为先的排查路径,最终把故障收敛到可复现的角色、连接、策略与 SQL 条件。
先把现象分成三类
RLS 故障先不要改策略。先记录发生故障的原始 SQL、数据库连接身份、事务状态、租户上下文和返回结果,再按现象分支。
| 现象 | 优先怀疑 | 典型机制 |
|---|---|---|
| 查到了其他租户的行 | 身份绕过 RLS、表所有者绕过、视图或函数改变执行身份、租户上下文串租 | 查询根本没有按预期角色执行 RLS |
| SELECT 返回空集,UPDATE/DELETE 影响 0 行 | USING 条件不成立、租户上下文缺失、策略角色或命令不匹配 |
行在进入用户查询条件前已被 RLS 隐藏 |
| INSERT/UPDATE 报 row-level security policy 错误 | WITH CHECK 不接受新行、目标租户与上下文不一致 |
新行状态没有通过写入校验 |
| 直接报 permission denied | Schema/Table ACL 不足 | 还没走到 RLS 的行级判断 |
尤其要区分“0 行”和“拒绝错误”。对于 UPDATE,旧行先受 USING 控制;旧行不可见时,语句通常只是影响 0 行。只有候选新行违反 WITH CHECK 时,才会产生 RLS 拒绝错误。
第一组证据先锁定执行身份
同一条 SQL 换一个数据库身份,RLS 结果可能完全不同。发生故障时,在同一条物理连接、同一事务中执行下面的探针,不要在另一个管理连接里代查。
SELECT
session_user,
current_user,
current_setting('role', true) AS active_role,
current_setting('app.tenant_id', true) AS tenant_id,
current_setting('row_security') AS row_security;正常情况下,你应该能解释每一列为什么是当前值。session_user 表示最初建立会话的身份,current_user 会受 SET ROLE 影响;RLS、权限检查以及许多安全边界更需要关注实际执行时的 current_user。
接着检查当前执行角色是否拥有绕过能力,以及它是否就是表所有者。
SELECT
r.rolname,
r.rolsuper,
r.rolbypassrls,
c.relowner::regrole AS table_owner,
c.relrowsecurity,
c.relforcerowsecurity
FROM pg_roles AS r
CROSS JOIN pg_class AS c
JOIN pg_namespace AS n
ON n.oid = c.relnamespace
WHERE r.rolname = current_user
AND n.nspname = 'app'
AND c.relname = 'orders';如果 rolsuper = true 或 rolbypassrls = true,该角色不会受到普通 RLS 约束。若 current_user 是表所有者,则默认也可绕过 RLS;只有对表启用 FORCE ROW LEVEL SECURITY 后,表所有者才通常受策略约束。排查“越权可见”时,这一组证据的优先级高于反复阅读策略表达式。
还要注意 row_security = off 不是一个普通的“关闭 RLS 并放行”开关。对于本应应用策略的查询,它用于让 PostgreSQL 报错而不是静默按策略过滤,常用于需要确认没有发生行过滤的维护场景,因此不要把它当作越权绕过手段。
再确认租户上下文有没有跟着事务走
共享连接池中的高频问题是:业务日志里显示 tenant A,但数据库连接上的 app.tenant_id 实际为空、仍是 tenant B,或者在事务结束后没有按预期失效。
在故障事务中直接读取租户上下文,并与业务请求里的可信租户标识比对。
SELECT
current_setting('app.tenant_id', true) AS tenant_id,
txid_current_if_assigned() AS txid;如果 tenant_id 为 NULL,而策略写成类似 tenant_id = current_setting('app.tenant_id', true)::bigint,结果通常不会匹配任何行;如果值残留为另一个租户,则可能造成错误可见范围,具体取决于策略表达式和应用是否还叠加了显式租户过滤。
连接池接入应重点核对三个事实:租户值是否由服务端可信身份解析得到,是否在 BEGIN 后通过 SET LOCAL 或 set_config(..., true) 写入,以及所有受保护 SQL 是否确实在同一事务和同一物理连接上执行。不要只看 ORM 层打印的参数,因为那不能证明数据库会话里的 GUC 值正确。
为了捕获串租,可以在复现环境连续执行两个租户事务,显式验证事务结束后的状态。
BEGIN;
SET LOCAL app.tenant_id = '101';
SELECT current_setting('app.tenant_id', true);
COMMIT;
SELECT current_setting('app.tenant_id', true);预期是事务内读到 101,COMMIT 后恢复为事务开始前的设置,而不是把 101 留在池连接里。若应用使用会话级 SET,连接归还池后旧值可能继续存在,这时应先修复上下文生命周期,而不是放宽 RLS 策略。
把 ACL 与 RLS 分开检查
RLS 不是表权限的替代品。一个角色必须先拥有 Schema 和 Table 所需权限,之后才有机会进入行级策略判断。看到 permission denied for schema 或 permission denied for table 时,应先检查 ACL。
SELECT
has_schema_privilege(current_user, 'app', 'USAGE') AS schema_usage,
has_table_privilege(current_user, 'app.orders', 'SELECT') AS can_select,
has_table_privilege(current_user, 'app.orders', 'INSERT') AS can_insert,
has_table_privilege(current_user, 'app.orders', 'UPDATE') AS can_update,
has_table_privilege(current_user, 'app.orders', 'DELETE') AS can_delete;如果普通授权为 false,先修复 GRANT 或角色继承关系。反过来,如果 ACL 足够但 SELECT 为空、UPDATE/DELETE 为 0 行,就继续查 USING;如果 INSERT 或 UPDATE 新行报 RLS 拒绝,则重点查 WITH CHECK。
这一步能避免一个常见误判:为了修复 ACL 问题去修改 RLS,结果不仅没有解决 permission denied,反而扩大了数据可见范围。
逐项核对实际生效的策略
不要只看迁移脚本或代码仓库里的定义,直接查询目标数据库上的 pg_policies。重点核对策略是否挂在正确表上、适用于哪个角色、哪个命令,以及 USING 和 WITH CHECK 的实际表达式。
SELECT
schemaname,
tablename,
policyname,
permissive,
roles,
cmd,
qual AS using_expr,
with_check
FROM pg_policies
WHERE schemaname = 'app'
AND tablename = 'orders'
ORDER BY policyname;检查时按命令拆开推理。SELECT 主要看 USING;DELETE 也依赖 USING 判断旧行是否可操作;UPDATE 既要让旧行通过 USING,又要让更新后的新行通过 WITH CHECK;INSERT 则重点看新行是否通过 WITH CHECK。
如果存在多条策略,还要检查它们的组合方式。PERMISSIVE 策略之间按 OR 组合,RESTRICTIVE 策略再作为额外 AND 条件叠加。越权问题常见于某条过宽的 PERMISSIVE 策略意外放行;误拦截则可能来自某条 RESTRICTIVE 条件在特定状态下恒为 false。
当仓库定义与 pg_policies 不一致时,优先把它当作部署漂移处理:确认目标数据库、Schema、迁移版本和变更时间,而不是凭代码仓库推断线上真实状态。
用最小 SQL 判断是哪一层过滤了行
完成身份、上下文、ACL 和策略核对后,使用最小查询复现,不要一开始就带复杂 JOIN、视图、ORM 自动条件或分页。
先取一条已知属于当前租户的业务主键,用当前故障连接执行:
SELECT id, tenant_id
FROM app.orders
WHERE id = 70001;如果返回 0 行,再由具备受控诊断权限的 DBA 使用独立管理会话确认物理行是否存在,并记录其 tenant_id。管理会话的结果只能证明“行存在”,不能证明应用角色应该看得到它。
对 UPDATE,使用 RETURNING 能把“命中了旧行”和“生成的新行”放到同一个验证动作里。
UPDATE app.orders
SET status = 'processing'
WHERE id = 70001
RETURNING id, tenant_id, status;结果为 0 行时,优先回到旧行的 USING、当前租户上下文和用户 WHERE 条件;如果报 new row violates row-level security policy,说明旧行已经进入更新路径,但新行没有通过 WITH CHECK,这时检查触发器、默认值和应用赋值是否改变了 tenant_id 或其他策略字段。
对于复杂查询,可在复现角色下使用 EXPLAIN (VERBOSE, COSTS OFF) 观察计划中的过滤条件,但不要把执行计划当成唯一证据。RLS 表达式会参与查询重写与规划,最终计划形态还受优化器、函数属性和查询结构影响;真正的结论仍应由身份、上下文、策略定义和最小 SQL 共同验证。
越权与误拦截分别怎么收口
如果是越权可见,按“先身份、再执行边界、最后策略”的顺序收口:确认应用没有使用 superuser 或 BYPASSRLS;确认表所有者是否需要 FORCE ROW LEVEL SECURITY;确认视图和 SECURITY DEFINER 函数没有把执行身份切到可绕过 RLS 的角色;确认连接池中的租户上下文没有串租;最后再检查是否存在过宽的 PERMISSIVE 策略。
如果是空结果或 0 行,按“上下文、角色匹配、USING、业务 WHERE”的顺序收口。不要为了让数据重新出现而直接把策略改成 USING (true),因为这会把诊断问题升级为隔离漏洞。
如果是 INSERT/UPDATE 被拒绝,固定检查候选新行。最有效的办法是把应用准备写入的关键列显式列出来,对照 WITH CHECK 逐项求值,特别关注 tenant_id、状态字段、触发器改写和默认值。
最终应留下可复现证据包:故障 SQL、session_user/current_user、租户上下文、角色的 superuser/BYPASSRLS 属性、表 owner 与 FORCE RLS 状态、ACL 检查、pg_policies 快照、最小复现结果以及修复后的双租户回归结果。这样下一次再出现“越权还是误拦截”的争论时,可以直接从数据库事实定位到具体边界,而不是靠猜测修改策略。