本地 Docker 容器的“网络端点状态异常”,如何快速修复

故障总结

这次不是业务代码故障,核心是本地 Docker 容器的"网络端点状态异常"。

具体表现:

  • aigc-php-local 容器配置里写着加入网络 docker-compose-local-aigc_host
  • 但实际 docker inspect 看到 NetworkSettings.Networks 是空的 {},说明容器对象没有真正挂到 Docker 网络
  • 因此 PHP 启动时解析不到 redis,在 QueueHelper.php 连接 Redis 直接报错退出
  • aigc-nginx-local 和 aigc-node-local 也出现了同类问题,所以 nginx 又解析不到 aigc-php-local / aigc-node-local

本质上是:

  • 容器"看起来存在"
  • docker compose ps 里也可能显示正常或重启中
  • 但容器实际没有拿到 compose 网络的 DNS 能力,导致服务名解析失败

这次看到的直接报错

  • PHP:
    RedisException: php_network_getaddresses: getaddrinfo failed
  • Nginx:
    host not found in upstream "aigc-php-local"
    host not found in upstream "aigc-node-local"

快速判断方法

先看容器状态:

powershell 复制代码
docker compose -f D:\phpstudy_pro\WWW\zhilin\aigc\docker-compose-local\docker-compose.yaml ps

再看失败日志:

powershell 复制代码
docker logs --tail 100 aigc-php-local
docker logs --tail 100 aigc-nginx-local
docker logs --tail 100 aigc-node-local

再看是不是网络端点丢了:

powershell 复制代码
docker inspect --format '{{json .NetworkSettings.Networks}}' aigc-php-local
docker inspect --format '{{json .NetworkSettings.Networks}}' aigc-nginx-local
docker inspect --format '{{json .NetworkSettings.Networks}}' aigc-node-local

如果输出是 {},基本就可以确定是这类问题。

下次怎么快速修复

优先用最小修复,直接强制重建异常容器:

powershell 复制代码
docker compose -f D:\phpstudy_pro\WWW\zhilin\aigc\docker-compose-local\docker-compose.yaml up -d --force-recreate php
docker compose -f D:\phpstudy_pro\WWW\zhilin\aigc\docker-compose-local\docker-compose.yaml up -d --force-recreate node
docker compose -f D:\phpstudy_pro\WWW\zhilin\aigc\docker-compose-local\docker-compose.yaml up -d --force-recreate nginx

如果你想一步到位,也可以:

powershell 复制代码
docker compose -f D:\phpstudy_pro\WWW\zhilin\aigc\docker-compose-local\docker-compose.yaml up -d --force-recreate

推荐的排查顺序

  1. 先看 php 日志
  2. 如果报 redis/mysql/host not found,立刻检查 NetworkSettings.Networks
  3. 如果是 {},不要先改代码,先 --force-recreate
  4. 然后再看 nginx 是否还报 upstream 解析失败
  5. 最后用接口实测一次

一套最快恢复命令

powershell 复制代码
docker compose -f D:\phpstudy_pro\WWW\zhilin\aigc\docker-compose-local\docker-compose.yaml up -d --force-recreate php node nginx
docker compose -f D:\phpstudy_pro\WWW\zhilin\aigc\docker-compose-local\docker-compose.yaml ps
docker logs --tail 50 aigc-php-local
docker logs --tail 50 aigc-nginx-local

怎么确认已经恢复

看这几个点:

  • docker compose ps 里 php / node / nginx 都是 Up
  • docker inspect --format '{``{json .NetworkSettings.Networks}}' 容器名 不再是 `{}``
  • php 日志里没有 getaddrinfo failed
  • nginx 日志里没有 host not found in upstream
  • 本地接口能返回 HTTP 200 或至少返回业务层错误,而不是容器层错误

一句话记忆

下次如果看到:

  • getaddrinfo failed
  • host not found in upstream

先别怀疑代码,先查容器是不是"名义上在网络里,实际上没挂上网络端点";如果是,直接 docker compose up -d --force-recreate 重建对应容器。

相关推荐
我不会插花弄玉4 小时前
13.多路转接epoll【由浅入深-网络】
网络·c++·epoll
最强小杰5 小时前
某 OpenAI 兼容网关上的 `kimi-k3.1-pro`:Cline、Zed 接入与 SSE 排错示例
java·服务器·网络·ai
byte轻骑兵9 小时前
如何为你的 Web 应用添加文档编辑能力:ONLYOFFICE 文档集成实战
docker·私有化部署·系统集成·在线协作·wsl2·onlyoffice docs
上海潭龙东海科技有限公司11 小时前
智慧堆场动态模型三维实时孪生重构智能管控
大数据·网络·数据库·算法·重构
好用斋13 小时前
内网测速 LibreSpeed:网页版 Docker 测速服务
运维·docker·容器
jianqiang.xue15 小时前
把Agent塞进MCU:工具次数和上下文长度怎么卡
java·前端·网络·单片机·esp32·ai编程
离凌寒17 小时前
一、关于qt编写的mqtt工具与tcp工具使用说明
网络·网络协议·tcp/ip
羽落•无痕(苏晗默)17 小时前
华为数通IA——14、网络服务与应用:TCP/UDP 传输层协议与 FTP、Telnet、SSH 实践
网络·网络协议·tcp/ip·网络安全·华为·udp·信息与通信
0xBADCODE17 小时前
2026 工业互联网安全大赛 · 全国预选赛题解系列密码学方向 crypto-5
网络·安全·web安全·网络安全·系统安全·密码学
菜地里的小菜鸟18 小时前
Docker 19.03.8 升级到 20.10.24
docker·云原生·容器·docker19038升级到201024