恢复PostgreSQL数据库备份时遇function public.pg_stat_statements_reset()不存在错误

核心问题分析 #

你遇到的情况大概率是目标数据库虽已全局安装pg_stat_statements扩展，但未在当前数据库中创建该扩展的实例，或是修改配置后未重启服务导致扩展未加载。以下是分步解决方法：

1. 先在目标数据库中显式创建扩展 #

用超级用户（比如postgres）连接目标数据库，执行：

CREATE EXTENSION IF NOT EXISTS pg_stat_statements;

执行完成后再重新执行恢复命令。注意：全局安装扩展不代表每个数据库都会自动生成该扩展的实例，必须手动在目标库执行创建操作。

2. 确认PostgreSQL服务已重启 #

你已经在pg.conf中配置了shared_preload_libraries = 'pg_stat_statements'，但修改这个参数后必须重启PostgreSQL服务才能生效。如果没重启，扩展实际上没有被加载，自然找不到对应的函数。

以Linux系统为例，重启命令：

sudo systemctl restart postgresql

3. 检查扩展所在的Schema #

如果创建扩展后仍报错，排查扩展所在Schema是否在当前搜索路径内：

-- 查看pg_stat_statements所在的Schema
SELECT nspname FROM pg_extension e JOIN pg_namespace n ON e.extnamespace = n.oid WHERE e.extname = 'pg_stat_statements';

-- 查看当前搜索路径
SHOW search_path;

如果扩展不在public且搜索路径未包含它，要么修改搜索路径，要么在备份文件中将pg_stat_statements_reset()改为[扩展所在Schema].pg_stat_statements_reset()。

4. 调整备份恢复的执行顺序 #

如果备份文件中调用pg_stat_statements_reset()的语句在CREATE EXTENSION之前执行，就会触发报错。可以：

• 先手动在目标库创建扩展，再执行恢复；
• 或者编辑备份文件，把CREATE EXTENSION IF NOT EXISTS pg_stat_statements;放在所有调用该函数的语句之前。

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