Postgres auto_explain模块无法捕获node-postgres查询执行计划

核心问题分析 #

你遇到的问题源于两个关键原因：

• 在psql中临时执行的LOAD 'auto_explain'和相关SET命令仅对当前psql会话生效，而node-postgres创建的是全新的数据库连接会话，不会继承这些配置。
• node-postgres默认使用预准备语句（prepared statements）（日志中显示的<unnamed>就属于这类语句），而PostgreSQL 10的auto_explain模块默认不会记录预准备语句的执行计划。

正确配置步骤 #

1. 全局加载auto_explain模块 #

修改postgresql.conf文件，添加/修改以下配置（确保容器内可编辑该文件，或通过环境变量挂载配置）：

shared_preload_libraries = 'auto_explain'

若已有其他预加载库，用逗号分隔，例如shared_preload_libraries = 'pg_stat_statements,auto_explain'

2. 配置auto_explain全局参数 #

在postgresql.conf中添加或修改以下配置：

# 记录所有查询的执行计划（0表示无时长限制）
auto_explain.log_min_duration = 0
# 记录实际执行统计（如耗时、返回行数）
auto_explain.log_analyze = true
# 记录详细计划信息（如字段类型、表结构）
auto_explain.log_verbose = true
# 记录嵌套语句的执行计划
auto_explain.log_nested_statements = true
# 关键配置：开启预准备语句的执行计划记录
auto_explain.log_prepared_statements = true

同时保留你已设置的配置：

log_statement = 'all'

3. 重启PostgreSQL容器 #

修改配置后必须重启PostgreSQL服务，确保新配置生效。

4. 验证配置 #

重启后进入容器的psql，执行以下命令确认配置生效：

-- 确认auto_explain已被预加载
SHOW shared_preload_libraries;
-- 确认预准备语句日志已开启
SHOW auto_explain.log_prepared_statements;

测试验证 #

重新启动fastify后端并发起参数化查询，此时PostgreSQL日志中会同时显示execute <unnamed>的查询语句，以及对应的QUERY PLAN执行计划内容。

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