PostgreSQL恢复时提示角色不存在

备份开始恢复后出现 role does not exist,不一定是备份坏了。PostgreSQL 的单库逻辑备份可以保存对象属于谁、授权给谁,却不负责把整个实例的角色一起创建出来。迁移目标缺少这些角色时,表可能已经导入,所有者、授权或行级安全策略却没有按计划恢复。

本文适用于 PostgreSQL 14–18 的逻辑恢复排查。先保留完整错误和对应 SQL,所有重试都放在独立测试实例的全新空库中,不在正式库逐条试错。

先看报错停在哪一条语句

错误出现位置 它在要求什么 处理重点
连接时就出现 FATAL,尚未执行对象 SQL 用于连接的角色存在于目标实例,并具备登录条件 检查主机、端口、-U 与原连接配置,先排除连错实例。
ALTER … OWNER TO 或 SET SESSION AUTHORIZATION 恢复原对象所有者或创建身份 决定保留原归属还是重新指定归属,不与应用登录账号混为一谈。
GRANT … TO 或 REVOKE … FROM 把访问权限赋给或移出指定角色 核对目标业务角色及权限设计,不能只为了跑完而省略授权。
CREATE POLICY … TO 等对象定义 定义本身引用了指定角色 核对这条策略或对象的业务含义;忽略 OWNER、ACL 不能替它改写角色名。

不要只看最后一行“忽略了若干错误”。先从日志中找到第一条缺失角色及对应语句。后面的失败可能来自同一处缺失,也可能是另一类依赖。

把源角色与目标角色列成对应关系

在目标实例的现有管理连接中执行以下只读查询,把角色名改成错误里的实际名称;带大小写的名称按原样核对:

SELECT current_database(), current_user,
       inet_server_addr(), inet_server_port(), version();

SELECT rolname, rolcanlogin, rolsuper
FROM pg_roles
WHERE rolname IN ('legacy_owner', 'legacy_reader');

某个名称没有返回,说明它在当前连接的实例中不存在;rolcanlogin=false 只表示不能直接作为登录身份,角色仍可用于持有对象或组织权限。本机 Unix socket 连接的网络地址可能为空,应结合实际连接参数确认目标。

对每个旧角色记录用途、引用对象、目标身份和需要的权限。比如原对象所有者、只读查询角色、网站登录角色可以有不同安排,不要全部并到管理员账户。角色是实例范围的资源,不能把另一服务器的完整角色脚本直接灌进一个已有业务的实例。

自定义或目录格式备份可先生成结构预览。以下 Bash 命令只读取归档、写入新建的私有临时目录,不连接数据库;替换真实备份路径:

umask 077
review_dir=$(mktemp -d /var/tmp/pg-role.XXXXXXXX) &&
pg_restore --schema-only --file="$review_dir/schema.sql" /backup/app.dump &&
printf 'Schema review: %s\n' "$review_dir/schema.sql"

仅在命令成功后审查完整预览,查看报错角色出现在哪些定义中。预览包含业务结构和函数逻辑,限制访问;不要把生成的 SQL 直接执行到正在使用的库。

选定恢复策略,再处理引用

保留原权限模型:根据源端记录,在隔离目标准备必要角色、成员关系和属性。单纯用于持有对象的角色可按设计设为不允许登录;实际应用账号另行配置。只补齐确实需要的权限,不给所有缺失角色加超级用户权限,也不因名字相同就沿用目标实例中用途不同的现有角色。

改用新的权限模型:--no-owner 控制原所有权的恢复,--no-privileges 控制原访问授权的恢复。它们适合经过设计的隔离演练,但不会完成角色映射。改变 -U 或使用 --role 也只是选择连接、执行身份,不会逐个替换备份中的旧角色名。

若报错来自策略、函数代码或其他显式角色引用,先由维护者审查对应对象,再针对该定义调整。不要全局替换备份字符串,避免误改数据内容、函数逻辑或本应保留的其他身份。纯文本 SQL 不能直接套用 pg_restore 的这些参数,应重新生成符合目标设计的导出或审查后的恢复脚本。

基础隔离恢复流程见PostgreSQL备份与恢复验证教程。重试保留退出码与日志;--exit-on-error 可在 SQL 报错时停止,但单用它不保证前面已执行的内容自动回滚。失败后重新准备空测试库,不用覆盖导入掩盖残留状态。

验证所有者和应用能做的事

恢复完成后,按实际 schema 查询表归属及行级安全策略:

SELECT schemaname, tablename, tableowner
FROM pg_tables WHERE schemaname='app';

SELECT schemaname, tablename, policyname, roles
FROM pg_policies WHERE schemaname='app';

上面只检查了表和策略,仍需核对业务函数、序列等对象。对已确认存在的角色及对象,可进一步查询明确权限:

SELECT has_schema_privilege('app_user', 'app', 'USAGE');
SELECT has_table_privilege('app_user', 'app.orders', 'SELECT');

权限查询为真也不能证明行级安全的可见数据正确。最后用真实应用角色在隔离环境验证预期可读、可写范围及应被拒绝的操作;涉及序列生成、函数执行的业务也要覆盖。所有者、权限和业务结果都符合目标设计,才算把角色依赖恢复完整。