docker-compose启动postgres报5432端口被占用异常排查

核心报错说明 #

执行docker-compose up时抛出的bind: address already in use代表宿主机5432端口已被其他进程监听，lsof -i :5432无返回通常是查询权限不足或者残留进程为root权限运行导致的，并非端口真的处于空闲状态。

第一步：先修正配置文件的显性错误 #

你的配置文件里存在几处会直接导致运行异常的问题，优先修改：

1. docker-compose.yml修复点：
   • postgres服务重复定义了两次environment块，后定义的配置会覆盖前序内容，保留一份即可
   • web服务的代码挂载路径和Dockerfile内声明的工作目录不一致，会导致容器内找不到项目代码
   • 没有指定多阶段构建的target，默认会构建最后一个CI阶段镜像，不符合本地开发需求
   • 修正后的完整配置参考：

   version: '3.5'
   services:
     postgres:
       image: postgres
       environment:
         POSTGRES_PASSWORD: password
       ports:
         - '5432:5432'
       volumes:
         - ./tmp/db:/var/lib/postgresql/data
   
     web:
       build:
         context: .
         target: dev # 开发环境用dev阶段，生产环境替换为deploy
       command: bash -c "rm -f tmp/pids/server.pid && bundle exec rails s -p 3000 -b '0.0.0.0'"
       volumes:
         - .:/app # 和Dockerfile内WORKDIR路径保持一致
       ports:
         - "3000:3000"
       depends_on:
         - postgres
   

2. Dockerfile修复点：
   • 所有apk配置段里的单引号是中文全角字符，替换为英文半角单引号，否则构建阶段会直接报错
   • 原配置中RUN RAILS_ENV=staging ...属于无效指令，RUN执行时声明的环境变量不会持久化到镜像内，需要替换为ENV指令
   • 修正后对应片段参考：

   # 替换原无效的RUN环境变量段
   ENV RAILS_ENV=staging \
       DATABASE_URL=postgres://postgres:password@postgres:5432/your_app_db?encoding=utf8&pool=5 \
       SECRET_KEY_BASE=blah
   

第二步：排查并解决端口占用问题 #

按顺序执行以下操作，覆盖常规排查未触达的场景：

• 用更高权限的端口查询命令替代lsof：执行sudo ss -tulpn | grep :5432，该命令可以列出所有root进程的端口监听情况。如果返回结果中存在postgres系统服务相关进程，记录PID后执行sudo kill -9 <PID>强杀，再执行sudo systemctl disable --now postgresql禁止系统自带PostgreSQL服务开机自启。
• 清理Docker残留代理进程：执行sudo pkill -f docker-proxy杀掉所有残留的Docker端口代理进程，再执行sudo systemctl restart docker重启Docker服务。
• 如果上述操作后仍报端口占用，可临时修改端口映射规避：将postgres服务的ports配置改为- '5433:5432'，容器内部服务间通信仍走5432端口不影响业务，仅宿主机连接数据库时改用5433端口即可。
• 极端场景下iptables残留DNAT规则也会导致端口绑定失败，重启Docker服务会自动重建iptables规则，无需手动修改。

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