从备份恢复PostgreSQL数据库失败：public.uuid_generate_v1()不存在

问题说明 #

执行以下恢复命令时失败：

pg_restore -h localhost -p 5432 -U postgres -d mydatabase -v "mybackupfile.backup"

报错信息：

pg_restore: error: could not execute query: ERROR:  function public.uuid_generate_v1() does not exist
LINE 53:     uuid uuid DEFAULT public.uuid_generate_v1(),
                               ^
HINT:  No function matches the given name and argument types. You might need to add explicit type casts.

目标系统已安装uuid-ossp扩展，但仍触发该错误。

解决步骤 #

1. 确认目标库的public模式下已正确安装uuid-ossp扩展 #

登录目标数据库，执行SQL检查扩展状态：

SELECT * FROM pg_extension WHERE extname = 'uuid-ossp';

如果返回空结果，说明扩展未安装到当前目标库，执行安装命令：

CREATE EXTENSION IF NOT EXISTS "uuid-ossp" SCHEMA public;

或者直接用命令行一键执行：

psql -h localhost -p 5432 -U postgres -d mydatabase -c "CREATE EXTENSION IF NOT EXISTS \"uuid-ossp\" SCHEMA public;"

2. 调整恢复顺序（针对备份未包含扩展创建逻辑的情况） #

如果备份文件里没有存储uuid-ossp扩展的创建语句，恢复时会优先创建依赖该函数的表，导致报错。此时需要先手动安装好扩展，再执行pg_restore恢复操作。

3. 修正函数的模式匹配（若扩展安装在非public模式） #

如果扩展已安装，但函数不在public模式，可将函数迁移到public模式：

ALTER FUNCTION 你的模式名.uuid_generate_v1() SET SCHEMA public;

或者直接修改表定义中的函数路径，替换为实际存在的模式。

4. 尝试添加--no-tablespaces参数恢复（可选） #

部分场景下表空间差异会间接引发函数查找问题，可尝试添加参数重新恢复：

pg_restore -h localhost -p 5432 -U postgres -d mydatabase -v --no-tablespaces "mybackupfile.backup"

内容的提问来源于stack exchange，提问作者Lokomotywa