Docker启动PostgreSQL失败：端口已占用问题求助

从错误日志和描述来看，核心矛盾是：PostgreSQL初始化完成重启时提示5432端口被占用，但实际无进程监听该端口，多次执行启动命令却能成功。

这是TCP TIME_WAIT状态的特性导致的：

• PostgreSQL初始化阶段会临时启动实例执行/docker-entrypoint-initdb.d/中的迁移脚本，完成后该实例关闭
• 关闭后5432端口会进入TIME_WAIT状态（TCP协议规定，连接关闭后端口会保留一段时间，防止旧数据包干扰新连接）
• 由于使用了--network host，容器直接复用主机网络栈，PostgreSQL重启绑定端口时，TIME_WAIT状态的端口会导致绑定失败；等待TIME_WAIT超时（CentOS7默认60秒）后，端口可正常绑定，多次执行刚好避开了这个超时窗口

方案1：开启PostgreSQL端口复用（推荐） #

PostgreSQL 11及以上版本支持reuse_port参数，允许复用处于TIME_WAIT状态的端口，直接在启动命令的PostgreSQL参数中添加该配置：

sudo docker run --rm \
--name postgres \
-e POSTGRES_DB=mydb \
-e POSTGRES_USER=myuser \
-e POSTGRES_PASSWORD="mypass" \
-e PGDATA=/var/lib/postgresql/data/pgdata \
-v /etc/mydb/migrations/:/docker-entrypoint-initdb.d/ \
-v /mnt/mydb:/var/lib/postgresql/data \
--network host \
postgres:15.2-alpine \
postgres -c max_connections=1000 -c listen_addresses='0.0.0.0' -c reuse_port=on

方案2：改用Docker端口映射，避开主机网络冲突 #

去掉--network host，改用Docker端口映射，让Docker处理端口的网络隔离和复用，避免主机TIME_WAIT的影响：

sudo docker run --rm \
--name postgres \
-e POSTGRES_DB=mydb \
-e POSTGRES_USER=myuser \
-e POSTGRES_PASSWORD="mypass" \
-e PGDATA=/var/lib/postgresql/data/pgdata \
-v /etc/mydb/migrations/:/docker-entrypoint-initdb.d/ \
-v /mnt/mydb:/var/lib/postgresql/data \
-p 5432:5432 \
postgres:15.2-alpine \
postgres -c max_connections=1000 -c listen_addresses='0.0.0.0'

方案3：调整主机TCP参数，缩短TIME_WAIT超时 #

编辑/etc/sysctl.conf文件，添加以下配置：

net.ipv4.tcp_fin_timeout = 30
net.ipv4.tcp_tw_reuse = 1
net.ipv4.tcp_tw_recycle = 0

执行sudo sysctl -p让配置生效，这样TIME_WAIT状态的端口会更快被系统回收，减少绑定失败的概率。

启动失败后立即执行以下命令，查看是否有处于TIME_WAIT状态的5432端口，确认问题根源：

sudo ss -tulpn | grep TIME-WAIT | grep 5432

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