docker-compose创建容器初始正常后自动重启 8081端口无法连接

核心原因 #

容器初始显示Up状态是Docker刚执行启动命令的瞬时状态，此时Docker会按配置渲染端口映射规则；后续容器进入restarting状态、端口映射消失，本质是容器内主进程启动后短时间内异常退出，触发了配置的自动重启策略，服务始终没有完成正常启动、没有真正在8081端口提供监听，所以访问localhost:8081会提示连接被拒绝。

排查步骤 #

• 第一步优先抓取崩溃日志定位根因
  直接执行命令查看最近50行服务日志并持续跟踪输出：

  # 知道compose服务名用这个，服务名是docker-compose.yml的services下定义的键名
  docker-compose logs -f --tail=50 <你的服务名>
  # 记不住服务名先查所有容器拿到容器ID/容器名，再查日志
  docker ps -a
  docker logs -f --tail=50 <容器ID/容器名>
  

  日志里会直接打印崩溃原因，高频错误包括：应用连接数据库/中间件失败、启动路径/执行权限错误、运行时依赖缺失、端口配置冲突。
• 第二步核对配置类高频错误
  打开docker-compose.yml逐项核对：
  • 端口映射格式是否正确：端口映射规则要写成"8081:容器内应用实际监听端口"，注意冒号左侧是宿主机端口、右侧是容器内部端口，两侧端口不要求一致，要是应用实际监听8080，就要把映射改成"8081:8080"
  • 检查重启策略配置：如果配置了restart: always/restart: unless-stopped，主进程只要非手动停止就会自动重启，就会出现端口时有时无的循环重启现象
  • 检查依赖服务状态：如果当前服务依赖数据库、消息队列等其他组件，要确认依赖的服务已经正常启动、网络连通性正常，否则应用启动时连不上依赖会直接退出
• 第三步验证端口监听配置
  如果日志没有打印明确错误，可以临时把服务启动命令改成阻塞命令让容器保持运行，比如临时在服务配置下加command: tail -f /dev/null，重新执行docker-compose up -d启动容器后，进入容器内部验证端口监听状态：

  # 进入容器，sh进不去就换成bash
  docker exec -it <容器ID> /bin/sh
  # 容器内直接访问本地8081端口
  curl http://127.0.0.1:8081
  

  • 如果容器内访问都失败，说明应用本身没有正常在8081端口启动，需要检查应用自身的启动配置
  • 如果容器内可以正常访问，宿主机访问失败，基本是应用绑定了127.0.0.1回环地址，把应用监听地址改成0.0.0.0即可，容器网络环境下服务只有绑定0.0.0.0才能被宿主机、其他容器访问

注意：大部分Web框架（SpringBoot、Express、Flask等）默认开发配置会绑定127.0.0.1，部署到容器时必须修改监听地址为0.0.0.0，部分框架检测到无法对外暴露端口会直接终止进程触发重启。

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