Docker部署Postgres修改wal_level为logical后不生效，求排查

架构老林

2026-7-25

Docker中Postgres修改wal_level不生效的解决办法

核心问题：直接在Docker容器内修改postgresql.conf是临时操作。容器重启后，会基于原始Postgres镜像重新初始化文件系统，你修改的配置会被默认配置覆盖，所以重启后wal_level又变回replica。
正确操作步骤：
1. 备份容器内现有配置（可选但推荐）
  若未挂载数据卷，先把容器内的配置文件拷贝到本地目录，比如本地创建./postgres-data目录：
```
docker cp <你的postgres容器ID>:/var/lib/postgresql/data/postgresql.conf ./postgres-data/
```
2. 修改本地的postgresql.conf
  打开本地./postgres-data/postgresql.conf，找到wal_level配置项，修改为：
```
wal_level = logical
```
  注意如果配置项被注释（前面有#），要去掉注释符号。
3. 重新启动容器并挂载数据卷
  停止当前容器：
```
docker stop <你的postgres容器ID>
```
  删除旧容器（需重新挂载卷）：
```
docker rm <你的postgres容器ID>
```
  用挂载数据卷的方式重新启动Postgres容器，确保本地./postgres-data目录被挂载到容器内的/var/lib/postgresql/data：
```
docker run -d \
  --name <你的容器名称> \
  -v ./postgres-data:/var/lib/postgresql/data \
  -e POSTGRES_PASSWORD=<你的密码> \
  postgres:<你的镜像版本>
```
4. 验证配置是否生效
  进入容器执行命令：
```
docker exec -it <你的容器名称> psql -U postgres
```
  然后执行SQL命令：
```
SHOW wal_level;
```
  此时应返回logical。
额外注意事项：
- 若Postgres容器已挂载数据卷，直接修改本地挂载目录里的postgresql.conf，再重启容器即可，无需重新创建容器。
- 修改配置时请确保Postgres服务已停止，避免配置文件被进程覆盖。
- Debezium还需要配套设置max_replication_slots和max_wal_senders参数，可一并在postgresql.conf中配置：
```
max_replication_slots = 10
max_wal_senders = 10
```