// PostgreSQL 错误参考

PostgreSQL 42501:权限被拒绝

当前角色缺少语句所需的权限:针对表、模式、序列、函数或数据库。授予权限,或以具有该权限的角色连接。

SQLSTATE
42501
名称
insufficient_privilege
类别
语法错误或访问规则违规
错误信息
permission denied for table orders

它的意思

PostgreSQL 会检查语句涉及的每个对象的权限。42501 (insufficient_privilege)会指出对象的类型和名称,例如 permission denied for table orders, permission denied for schema app 或者 permission denied for sequence orders_id_seq。旧版本的说法是 relation 代替 table.

每个层级都需要权限: USAGE 在模式上,然后 SELECT, INSERT, UPDATE 或者 DELETE 在表上,以及 USAGE 在与 serial 列,供插入使用。

常见原因

  • 角色从未被授予该权限,或者授予的是其他表而非正在使用的表。
  • 在 GRANT ... ON ALL TABLES IN SCHEMA,它只覆盖当时就已存在的表。
  • 否 USAGE 在模式上,或者自 PostgreSQL 15 起没有 CREATE 在 public 普通角色的模式。
  • 向带有 serial 列,而没有 USAGE 在其序列上。
  • 更改或删除你不拥有的对象(must be owner of table orders,同一套代码)。

如何修复它

  1. 授予角色所需的表和模式权限。

    GRANT USAGE ON SCHEMA app TO app_user;
    GRANT SELECT, INSERT, UPDATE, DELETE ON ALL TABLES IN SCHEMA app TO app_user;
    GRANT USAGE ON ALL SEQUENCES IN SCHEMA app TO app_user;
  2. 通过默认权限覆盖以后创建的表(由创建表的角色设置)。

    ALTER DEFAULT PRIVILEGES IN SCHEMA app
        GRANT SELECT, INSERT, UPDATE, DELETE ON TABLES TO app_user;
  3. 检查角色拥有哪些权限。

    SELECT has_table_privilege('app_user', 'app.orders', 'INSERT'),
           has_schema_privilege('app_user', 'app', 'USAGE');
  4. 在 PostgreSQL 15 及更高版本中,授予 CREATE 在 public 显式授权,如果角色需要在其中创建对象。

    GRANT CREATE ON SCHEMA public TO app_user;

相关错误

更多语法错误或访问规则违例错误

代码和消息文本来自 PostgreSQL 文档,附录 A:PostgreSQL 错误代码。浏览完整的 PostgreSQL 错误列表 或者 搜索每个数据库错误.

// 错误更少,修复更快

在 SQLly 中使用 PostgreSQL

适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 PostgreSQL 以及你使用的其他数据库。