Docker部署PostgreSQL时max_wal_senders参数修改后始终为1不生效

从pg_settings返回的source: "command line"字段可以直接确认：当前max_wal_senders取值来自数据库启动时通过-c参数传入的命令行配置，PostgreSQL参数加载优先级中，命令行参数优先级高于postgresql.auto.conf（即ALTER SYSTEM写入的配置）、postgresql.conf配置文件，因此你之前修改配置文件、执行ALTER SYSTEM的操作都无法覆盖该值。

你修改docker-compose.yml中启动参数后仍不生效的核心原因是：docker restart操作只会沿用容器首次创建时保存的启动配置重启进程，不会读取你更新后的compose文件内容，新写的启动参数根本没有被传入数据库进程。

1. 先核对docker-compose.yml中postgres服务的command配置段，确认-cmax_wal_senders=10配置拼写正确，无多余空格、错字。
2. 执行以下命令强制重建容器，加载新的启动配置：

   docker-compose up -d --force-recreate <你的postgres服务名>
   

   如果你的compose文件里只定义了postgres单个服务，也可以直接执行docker-compose up -d --force-recreate。注意该操作会短暂中断数据库服务，生产环境请在维护窗口操作。
3. 容器启动完成后，连接数据库执行校验命令：

   SHOW max_wal_senders;
   

   正常返回值应为10，此时再查询pg_settings，setting和reset_val字段都会同步更新为10。

• PostgreSQL参数加载优先级从高到低固定为：启动命令行-c传入参数 > postgresql.auto.conf（ALTER SYSTEM写入的持久化配置） > postgresql.conf自定义配置 > 内置默认值，高优先级来源的配置会直接覆盖低优先级的同参数配置。
• 如果你更习惯通过修改配置文件、ALTER SYSTEM的方式调整参数，可以直接把compose启动命令里的-cmax_wal_senders=xxx配置段删除，重建容器后，配置文件和ALTER SYSTEM的修改就能正常生效。
• 如果是通过docker run命令启动的容器，修改启动参数需要先删除旧容器（docker rm -f <旧容器名/ID>），再用更新后的参数重新执行docker run创建新容器，单纯执行docker restart不会更新容器的启动参数。

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