Windows 11（WSL）环境下Postgres容器周期性崩溃排查求助

• 固定WSL 2资源配置
  即便未手动配置wslconfig，Windows后台可能对WSL实例做动态资源回收，导致Postgres进程被意外终止。手动创建C:\Users\<你的用户名>\.wslconfig文件，添加固定资源分配规则避免资源争抢：

  [wsl2]
  memory=32GB
  processors=8
  localhostForwarding=true
  

  保存后执行wsl --shutdown重启WSL，再启动容器测试。

• 排查系统层面异常日志
  Postgres崩溃时，同步检查两类日志定位触发原因：

  • WSL操作日志：在PowerShell中执行Get-WinEvent -LogName Microsoft-Windows-Subsystem-Linux/Operational，过滤崩溃时间点的事件，查看是否存在内存不足、磁盘IO错误或WSL内核异常。
  • Windows系统日志：打开事件查看器 → Windows日志 → 系统，排查是否有WSL虚拟磁盘（VHDX）相关的错误、警告，或系统资源回收记录。

• 禁用Postgres并行查询机制
  日志明确提到并行worker被终止，大概率是WSL环境下Postgres并行调度与Windows资源管理存在冲突。修改Postgres配置文件postgresql.conf：

  max_parallel_workers_per_gather = 0
  max_parallel_workers = 0
  

  重启Postgres容器后观察崩溃是否消失。若问题解决，再逐步调整参数（比如从1开始递增）找到兼容的并行配置。

• 检查Docker存储驱动与磁盘状态
  WSL 2下Docker默认使用overlay2驱动，部分场景下存在兼容性问题：

  • 打开Docker Desktop设置 → Resources → WSL Integration，确认目标WSL发行版处于启用状态，存储驱动为overlay2。
  • 检查WSL虚拟磁盘（VHDX）是否存在碎片，可通过Windows磁盘工具对VHDX所在分区执行碎片整理。

• 实时监控崩溃瞬间的系统状态
  在WSL终端安装htop、iostat工具，持续监控Postgres容器的资源使用：

  # 监控Postgres进程资源
  htop -p $(docker inspect --format '{{.State.Pid}}' <postgres容器名>)
  # 实时监控磁盘IO
  iostat -x 1
  

  重点关注崩溃瞬间是否出现CPU/内存骤升、磁盘IO饱和的情况。

• 隔离测试Postgres容器稳定性
  暂时停止Python应用容器，单独运行Postgres容器，用pgbench做压测验证：

  docker exec -it <postgres容器名> pgbench -U <用户名> -d <数据库名> -c 20 -j 4 -t 10000
  

  若单独压测仍崩溃，说明问题出在Postgres与WSL的适配层面；若压测稳定，再排查Python应用的连接逻辑（比如是否存在未正确释放的连接、异常查询触发并行worker）。

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