PostgreSQL / 系统课时

排查查不到行与策略拒绝

排查查不到行与策略拒绝

RLS 故障最容易混淆三种现象:查询正常返回 0 行、写入被策略拒绝,以及权限不足直接报错。排查时要先还原当前角色和租户上下文,再核对授权、RLS 开关与策略表达式,最后才修改策略。

学习目标

  • 区分 RLS 静默过滤、WITH CHECK 拒绝和普通权限错误
  • 按固定顺序检查 current_user、租户上下文、授权与策略状态
  • 在不关闭 RLS 的前提下定位并验证配置修复

先区分现象属于哪一层

SELECT 命中不到策略的 USING 条件时,PostgreSQL 通常只是把行过滤掉,所以“0 行”本身不代表数据库里没有数据。INSERT 或改变新行内容的 UPDATE 若不满足 WITH CHECK,则会直接报 RLS 违规。

如果连表级 SELECT、INSERT 或 UPDATE 权限都没有,错误会发生在 RLS 之前,常见信息是 permission denied for table ...。因此第一步不是改策略,而是确认当前会话到底以谁的身份执行。

PostgreSQL RLS 查不到行与策略拒绝排查流程

用一组只读 SQL 固定证据

下面是片段示例,假设目标表为 tenant_demo.orders,租户上下文保存在 app.tenant_id。在生产环境只读执行即可;若实际对象名不同,替换 Schema 和表名,不要先改 RLS 配置。

sql
SELECT
    session_user,
    current_user,
    NULLIF(current_setting('app.tenant_id', true), '') AS tenant_id,
    current_setting('row_security', true) AS row_security;

SELECT
    c.relrowsecurity AS rls_enabled,
    c.relforcerowsecurity AS force_rls,
    c.relowner::regrole AS table_owner,
    r.rolsuper AS current_user_superuser,
    r.rolbypassrls AS current_user_bypassrls
FROM pg_class AS c
JOIN pg_roles AS r
  ON r.rolname = current_user
WHERE c.oid = to_regclass('tenant_demo.orders');

SELECT
    has_schema_privilege(current_user, 'tenant_demo', 'USAGE') AS schema_usage,
    has_table_privilege(current_user, 'tenant_demo.orders', 'SELECT') AS can_select,
    has_table_privilege(current_user, 'tenant_demo.orders', 'INSERT') AS can_insert,
    has_table_privilege(current_user, 'tenant_demo.orders', 'UPDATE') AS can_update;

SELECT
    policyname,
    permissive,
    roles,
    cmd,
    qual,
    with_check
FROM pg_policies
WHERE schemaname = 'tenant_demo'
  AND tablename = 'orders'
ORDER BY policyname;

预期结果

text
session_user=<USER>
current_user=tenant_app
tenant_id=<ID>
row_security=on

rls_enabled=t
force_rls=t|f
table_owner=<USER>
current_user_superuser=f
current_user_bypassrls=f

schema_usage=t
can_select=t
can_insert=t
can_update=t

pg_policies 返回目标表实际生效的策略;roles、cmd、qual、with_check 应与当前操作匹配

<USER>、<ID> 和 force_rls 的实际值因环境而异。若第一组结果已经显示 current_user 错误或 tenant_id 为空,就应先修复会话初始化,而不是继续修改策略。

按 USING 与 WITH CHECK 解释结果

USING 决定哪些已有行对当前命令可见,主要影响 SELECT、UPDATE、DELETE 的候选行;WITH CHECK 决定 INSERT 或 UPDATE 产生的新行是否允许存在。没有适用策略时,RLS 采用默认拒绝。

多条 permissive 策略通常以 OR 组合,多条 restrictive 策略以 AND 追加限制。排障时不仅要看表达式本身,还要核对策略的 roles 与 cmd,否则“策略看起来正确”也可能根本没有作用于当前角色或命令。

常见根因与修复顺序

连接池最常见的问题是角色或租户上下文泄漏。每次事务开始时显式设置应用角色与租户,事务结束后让 SET LOCAL 自动恢复,比长期依赖会话级 SET 更安全。

授权不足时补齐最小的 Schema USAGE 和表级 DML 权限,但不要误以为 GRANT 会替代 RLS;授权通过后,策略仍然继续过滤。若当前角色是表 owner,普通情况下会绕过 RLS,启用 FORCE ROW LEVEL SECURITY 才会让 owner 受策略约束;超级用户和带 BYPASSRLS 属性的角色仍然绕过。

策略条件错误时,先用当前租户 ID 手工代入表达式检查类型转换、空值和列引用。尤其要警惕未设置 GUC 时直接做 ::bigint 导致异常,或 Schema 变更后策略仍引用旧列语义。

用事务级上下文验证修复

修复后不要只看一次业务请求是否“有数据”,而要同时验证身份、上下文和返回行的租户边界。下面示例假设租户 42 在 tenant_demo.orders 中至少有一条测试数据。

sql
BEGIN;

SET LOCAL ROLE tenant_app;
SET LOCAL app.tenant_id = '42';

SELECT
    current_user,
    NULLIF(current_setting('app.tenant_id', true), '') AS tenant_id;

SELECT
    count(*) AS visible_rows,
    bool_and(tenant_id = 42) AS all_rows_in_current_tenant
FROM tenant_demo.orders;

ROLLBACK;

预期结果

text
 current_user | tenant_id
--------------+----------
 tenant_app   | 42

 visible_rows | all_rows_in_current_tenant
--------------+---------------------------
 <N>          | t

ROLLBACK

这里 <N> 应大于 0,因为验收使用了已知存在数据的测试租户。若身份和上下文正确但仍为 0 行,再回到 pg_policies.qual 检查 USING;若读取正常而写入失败,则重点检查 WITH CHECK 和写入后的 tenant_id。这种分层顺序能避免把正常的安全过滤误修成更大的隔离漏洞。

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

目录与阅读设置

阅读设置

17

记录一个想法

排查查不到行与策略拒绝

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

登录哪都通