当 `docker-compose ps` 仅显示前端服务而未显示后端服务时，通常是由于 **后端服务未启动** 或 **配置错误** 导致的。以下是详细排查和解决方案： --- ### **一、可能原因** 1. **后端服务未定义**： - `docker-compose.yml` 中未正确声明后端服务（如漏写 `services.backend`）。 2. **服务依赖问题**： - 后端服务启动失败（如依赖的数据库未就绪），导致容器退出。 3. **网络配置错误**： - 后端服务未加入正确的网络，或前端配置的 `depends_on` 未生效。 4. **资源限制**： - 后端服务因内存/CPU不足被 OOM Killer 终止。 5. **日志被隐藏**： - 后端服务崩溃但未输出日志（如未配置 `tty: true`）。 --- ### **二、排查步骤** #### **1. 检查 `docker-compose.yml` 配置** - **确认后端服务已定义**： ```yaml services: frontend: # 前端服务 image: nginx:latest ports: - "80:80" depends_on: - backend backend: # 后端服务（必须存在） image: your-backend-image ports: - "8080:8080" environment: - DB_HOST=db ``` - **关键点**： - 确保 `services` 下有 `backend` 键。 - 检查 `image`、`build` 或 `context` 是否正确。 #### **2. 查看所有容器（包括已退出的）** - **使用 `docker-compose ps -a`**： ```bash docker-compose ps -a ``` - **输出示例**： ```plaintext Name Command State Ports ------------------------------------------------------------------------- myapp_frontend_1 nginx -g daemon off; Up 0.0.0.0:80->80/tcp myapp_backend_1 /app/start.sh Exit 1 # 状态为 Exit ``` - 如果后端状态为 `Exit` 或 `Created`，说明容器未正常运行。 #### **3. 检查后端容器日志** - **获取容器名或 ID**： ```bash docker-compose ps -a | grep backend ``` - **查看日志**： ```bash docker-compose logs backend # 实时日志 docker-compose logs --tail=50 backend # 最近50行 ``` - **常见错误**： - `Connection refused`：依赖的服务（如数据库）未启动。 - `Permission denied`：文件权限或 SELinux 问题。 - `No such file or directory`：启动脚本或二进制文件缺失。 #### **4. 验证服务依赖** - **检查 `depends_on`**： ```yaml frontend: depends_on: - backend # 仅控制启动顺序，不保证健康检查 ``` - **注意**： - `depends_on` 仅确保容器启动顺序，不检查服务是否就绪。 - 如需等待后端健康，需结合 `healthcheck` 和脚本（如 `wait-for-it`）。 #### **5. 检查网络配置** - **确认服务在同一网络**： ```yaml networks: default: driver: bridge ``` - 或显式指定网络： ```yaml backend: networks: - internal frontend: networks: - internal ``` - **测试网络连通性**： ```bash docker-compose exec frontend ping backend ``` #### **6. 检查资源限制** - **查看容器资源使用**： ```bash docker stats ``` - **检查 OOM 记录**： ```bash dmesg | grep -i "kill" # Linux 主机 ``` --- ### **三、解决方案** #### **1. 修复配置文件** - **补全后端服务定义**： ```yaml services: backend: image: node:16 working_dir: /app volumes: - ./backend:/app command: npm start ``` #### **2. 处理依赖服务** - **添加健康检查**（以数据库为例）： ```yaml db: image: postgres:14 healthcheck: test: ["CMD-SHELL", "pg_isready -U postgres"] interval: 5s timeout: 5s retries: 5 backend: depends_on: db: condition: service_healthy # 等待 db 健康 ``` #### **3. 手动启动后端服务** - **单独启动后端**： ```bash docker-compose up -d backend ``` - **进入容器调试**： ```bash docker-compose exec backend /bin/sh ``` #### **4. 清理并重建** - **删除旧容器并重建**： ```bash docker-compose down docker-compose up -d --build ``` --- ### **四、调试技巧** 1. **简化测试**： - 注释掉前端服务，仅启动后端： ```bash docker-compose up -d backend ``` 2. **使用 `docker-compose config`**： - 验证配置文件语法： ```bash docker-compose config ``` 3. **启用详细日志**： - 在 `docker-compose.yml` 中添加： ```yaml services: backend: logging: driver: json-file options: max-size: "10m" max-file: "3" ``` --- ### **五、总结** | 问题类型 | 排查命令/操作 | 解决方案 | |-----------------------|---------------------------------------|-----------------------------------| | 后端服务未定义 | `docker-compose config` | 补全 `services.backend` 配置 | | 容器启动失败 | `docker-compose logs backend` | 修复启动脚本或依赖问题 | | 网络不通 | `docker-compose exec ping` | 检查网络配置或服务地址 | | 资源不足 | `docker stats` + `dmesg` | 增加资源限制或优化应用 | --- ### **六、扩展建议** 1. **使用 `wait-for-it` 脚本**： - 在 `command` 中添加等待逻辑： ```yaml backend: command: sh -c "./wait-for-it.sh db:5432 -- npm start" ``` 2. **监控容器生命周期**： - 通过 `docker events` 实时监控容器状态变化： ```bash docker events --filter 'event=die' --format '{{.Time}} {{.ID}} {{.Status}}' ``` 3. **配置自动化重启**： - 在 `docker-compose.yml` 中添加： ```yaml backend: restart: on-failure:5 # 最多重启5次 ``` 如果问题仍未解决，请提供以下信息： 1. `docker-compose.yml` 的完整内容（隐藏敏感信息）。 2. `docker-compose logs backend` 的输出片段。 3. 执行 `docker-compose ps -a` 的结果。