为什么我的Compose服务总启动失败？
当你在终端看到docker-compose up报出鲜红的错误信息时，那种挫败感每个开发者都深有体会。Docker Compose作为容器编排的利器，其常见问题往往集中在配置错误、环境差异和资源竞争三个维度。我们先看几个最典型的症状：
- 依赖服务未就绪：数据库还没启动完成，应用服务已经尝试连接
- 端口被占用：Nginx的80端口被宿主机其他进程占用
- 权限问题：容器内进程对挂载卷没有写入权限
错误日志该怎么看？
假设你遇到web服务启动立即退出的情况，试试这个诊断组合拳：
- 运行
docker-compose logs --tail=50 web查看最后50行日志 - 添加
depends_on搭配healthcheck控制启动顺序 - 在服务定义中加入
stdin_open: true和tty: true保持容器运行
网络与端口冲突解决方案
你可能会问："明明配置了端口映射，为什么还是访问不了服务？"这通常涉及以下情形：
| 症状 | 排查命令 | 解决方案 |
|---|---|---|
| 端口被占用 | netstat -tulnp | grep 8080 |
修改compose文件的ports映射或停止占用进程 |
| 防火墙拦截 | sudo ufw status |
添加规则或临时关闭防火墙测试 |
| 绑定到127.0.0.1 | docker inspect 容器ID |
检查服务是否配置监听0.0.0.0 |
自定义网络的高级用法
对于多项目共存的情况，创建独立的Docker网络能有效隔离环境：
networks:
my_network:
driver: bridge
ipam:
config:
- subnet: 172.28.0.0/16环境变量与配置管理陷阱
有人会说："我在.env文件里明明设置了变量，为什么容器读取不到？"这涉及到Docker Compose的变量加载机制：
- 优先级问题：容器内环境变量 > compose文件environment > .env文件
- 变量未导出：.env文件需要放在项目根目录（docker-compose.yml同级）
- 特殊字符处理：包含空格或特殊符号的值必须用引号包裹
最佳实践建议
对于敏感配置，推荐使用Docker secrets或动态配置中心：
- 在swarm模式下创建secret：
echo "密码" | docker secret create db_pass - - 在compose文件中引用：
secrets: - db_pass - 非敏感配置可使用
configs挂载配置文件
磁盘空间与资源限制
随着项目运行，你可能突然发现docker-compose up报出"no space left on device"错误。这是Docker的磁盘占用膨胀问题：
- 查看磁盘使用：
docker system df显示各类型资源占用 - 清理无用资源：
docker system prune --volumes（慎用） - 限制日志大小：在compose文件配置
logging.driver和logging.options
记住，容器只是临时运行环境，重要数据务必通过volume持久化。下次当你再遇到Docker Compose常见问题时，不妨先冷静分析错误日志，从网络、配置、资源这三个维度入手排查，问题往往就能迎刃而解。