PostgreSQL 15复杂COUNT(*)查询在Spring Boot应用中挂起求助

核心差异定位 #

应用发起的查询在PostgreSQL中显示为parallel worker（并行查询工作进程），而DBeaver执行时为client backend（直接客户端连接进程），这是关键差异点——并行查询的异常协同很大概率是导致挂起的原因。

以下是具体排查方向和验证步骤：

1. 对比参数化与直接执行的执行计划 #

MyBatis的参数化查询（预编译）和DBeaver直接执行的SQL，可能生成完全不同的执行计划：

• 在DBeaver中执行带实际参数的EXPLAIN ANALYZE语句，记录执行计划（是否启用并行、并行度、扫描方式）
• 在应用中临时将MyBatis的参数化查询改为静态SQL（替换#{}为实际参数值），执行EXPLAIN ANALYZE并对比结果
• 重点关注：是否出现Parallel Seq Scan/Parallel Index Scan，并行进程数workers planned/workers launched，以及是否存在异常等待事件

2. 验证并行查询是否为问题根源 #

临时禁用PostgreSQL的并行查询，验证查询是否恢复正常：

• 在数据库中执行：

  SET max_parallel_workers_per_gather = 0;
  

• 重启应用或重新获取连接后执行挂起的查询，如果不再挂起，说明并行查询的协同逻辑出了问题

3. 检查PostgreSQL并行相关配置 #

查看Docker容器中的PostgreSQL配置，确认并行参数是否合理：

SHOW max_parallel_workers_per_gather;
SHOW max_parallel_workers;
SHOW parallel_setup_cost;
SHOW parallel_tuple_cost;

如果parallel_setup_cost或parallel_tuple_cost设置过低，可能导致PostgreSQL错误选择并行执行策略。可以尝试调高这两个参数，降低并行查询的触发概率。

4. 调整数据源与驱动配置 #

• HikariCP连接属性：检查事务隔离级别transactionIsolation是否与DBeaver一致（默认通常为READ COMMITTED），确认autoCommit设置是否符合预期（Spring Boot默认true，但事务中执行会改变行为）
• 禁用驱动侧并行查询：在数据源URL或HikariCP配置中添加参数强制关闭并行：

  # application.properties
  spring.datasource.url=jdbc:postgresql://host:port/db?parallelQueryMode=off
  # 或HikariCP属性
  spring.datasource.hikari.data-source-properties.jdbc.postgresql.parallelQueryMode=off
  

5. 定位数据库进程阻塞点 #

当查询挂起时，执行以下SQL查看进程状态：

SELECT pid, backend_type, wait_event_type, wait_event, query_start, state 
FROM pg_stat_activity 
WHERE query LIKE '%SELECT count(*)%';

• 如果wait_event_type为Lock，说明并行进程间出现锁等待
• 如果是IO类事件，结合DBeaver正常的情况，可排除网络/存储问题，重点排查并行进程的IO协同逻辑

6. 升级PostgreSQL驱动 #

当前使用的驱动版本为42.5.4，尝试升级到最新稳定版（如42.6.0），旧版本可能与PostgreSQL 15.2的并行查询存在兼容性bug。

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