问题：如何通过 `docker-compose up` 和 `docker logs` 查看服务启动日志？

Question

**问题描述：** 在使用 Docker Compose 部署服务时，执行 `docker-compose up` 后，如何实时查看服务的启动日志？如果服务启动失败，又该如何通过 `docker logs` 查看具体错误信息以进行故障排查？

Answer 1

一、Docker Compose 部署服务时的实时日志查看与故障排查

在使用 Docker Compose 部署微服务或复杂应用时，服务启动过程中可能会遇到各种问题。为了快速定位和修复这些故障，掌握如何实时查看日志以及如何使用 docker logs 查看错误信息是关键技能。

1. 实时查看服务启动日志

当执行 docker-compose up 命令后，默认情况下会进入前台模式（attached mode），并在终端中输出所有服务的日志信息：

docker-compose up

• 优点： 可以看到各服务的启动过程、依赖加载、配置初始化等详细信息。
• 缺点： 日志量大时难以快速定位问题，且无法后台运行。

如果希望以后台方式运行容器并同时查看日志，可以使用 -d 参数启动服务：

docker-compose up -d

随后使用如下命令查看某个服务的日志：

docker-compose logs -f <service_name>

参数	说明
-f	持续跟踪日志输出，类似 tail -f
--tail	指定显示最近 N 行日志，如 --tail 100

2. 服务启动失败后的日志分析

当服务未能正常启动时，需要借助 docker logs 命令来获取更详细的错误信息。首先，确认容器是否已经创建：

docker-compose ps

若状态为 exited 或 restarting，则可使用以下命令查看该容器的日志：

docker logs <container_id_or_name>

例如：

docker logs app_container_1

常见错误类型包括但不限于：

• 端口冲突：提示“address already in use”
• 数据库连接失败：如 PostgreSQL 未就绪导致服务异常退出
• 环境变量缺失：如缺少必要的 .env 文件或配置项
• 镜像拉取失败：网络问题或私有仓库认证失败

3. 进阶技巧与流程图

对于复杂部署场景，建议结合日志级别控制、多服务过滤等功能提升效率：

• 按服务名组合查看多个日志：docker-compose logs -f service1 service2
• 设置日志时间范围：docker-compose logs --since "5m"
• 将日志输出到文件进行分析：docker-compose logs > logs.txt

以下是服务启动失败排查的流程图示意：

graph TD
      A[执行 docker-compose up] --> B{服务是否正常运行?}
      B -- 是 --> C[继续观察日志]
      B -- 否 --> D[检查容器状态: docker-compose ps]
      D --> E{容器是否存在?}
      E -- 存在 --> F[查看日志: docker logs container_id]
      E -- 不存在 --> G[检查 compose 文件语法或镜像构建]
      F --> H[根据日志定位错误原因]