PostgreSQL配置shared_preload_libraries后创建pg_stat_statements报错如何解决

问题成因 #

• 修改的不是当前运行PostgreSQL实例实际加载的postgresql.conf配置文件，配置改动没有被实例读取
• 配置项格式错误：shared_preload_libraries参数前残留#注释符号、多预加载库未用英文逗号分隔、使用了中文引号等非法符号
• 系统未安装pg_stat_statements对应的依赖包，PostgreSQL启动时无法找到对应共享库，加载失败，错误通常会记录在数据库运行日志中
• 数据库重启未成功：重启操作执行报错，原有旧进程仍在运行，始终加载旧的配置
• 多实例部署场景下，重启的是其他端口的PostgreSQL实例，当前操作的实例未加载新配置
• 容器化部署场景下，修改的是宿主机本地未挂载进容器的配置文件，或容器重启时配置被镜像默认值覆盖

处理步骤 #

1. 确认当前实例加载的配置文件路径，执行SQL：
   show config_file;
   对比输出路径是否为你修改的配置文件路径，如不一致修改正确路径下的配置文件。
2. 检查配置项格式是否符合要求：
   • 参数前无#注释符
   • 多预加载库用英文逗号分隔，示例：shared_preload_libraries = 'pg_cron,pg_stat_statements'
   • 所有符号均为英文半角符号
3. 安装pg_stat_statements依赖包：
   • Debian/Ubuntu系统执行：apt install postgresql-$(psql -t -c 'show server_version_num' | xargs | cut -c1-2)-contrib
   • RHEL/CentOS/Fedora系统执行：dnf install postgresql$(psql -t -c 'show server_version_num' | xargs | cut -c1-2)-contrib
4. 确认数据库重启生效，执行SQL查看启动时间：
   select pg_postmaster_start_time();
   若返回时间早于你执行重启操作的时间，排查启动失败原因，查看数据库运行日志中的错误信息，重新执行重启操作。
5. 重启后验证预加载参数是否生效，执行SQL：
   show shared_preload_libraries;
   返回结果中包含pg_stat_statements后，再执行create extension if not exists pg_stat_statements;创建扩展即可。

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