为何Docker Compose未创建指定container_name的web服务容器？

针对你遇到的web服务容器未创建的问题，按以下步骤逐一排查：

1. 确认镜像是否存在且有效 #

你提到构建了django-image镜像，先通过命令确认镜像确实存在：

docker images | grep django-image

如果没有结果，说明镜像构建失败或未执行构建命令。重新执行构建并留意输出中的错误（比如requirements.txt缺失、依赖安装失败等）：

docker build -t django-image .

2. 检查docker-compose启动命令是否正确 #

如果仅执行docker-compose up db，只会启动db服务，web服务不会被创建。需要执行：

docker-compose up  # 启动所有服务
# 或单独启动web服务
docker-compose up web

若需后台运行，添加-d参数：docker-compose up -d

3. 查看web服务的启动日志 #

即使容器创建后立刻退出，也能通过日志定位原因：

docker-compose logs web

常见问题包括：

• 缺少启动命令：你的Dockerfile未定义CMD或ENTRYPOINT来启动Django服务，容器启动后无进程运行会立刻退出。需在Dockerfile末尾添加启动命令，例如：

  CMD ["python", "manage.py", "runserver", "0.0.0.0:8000"]
  

  添加后重新构建镜像并启动服务。
• 数据库未就绪：depends_on仅保证db容器启动，但PostgreSQL可能未完成初始化就被Django连接，导致应用启动失败。可在web服务中添加等待脚本，或修改Django的数据库连接重试逻辑。
• 目录权限问题：挂载的本地目录./code-django权限不足，容器内进程无法访问，导致启动失败。可检查本地目录权限，或在Dockerfile中设置合适的用户权限。

4. 检查端口是否被占用 #

若本地8000端口已被其他进程占用，web容器启动会失败。检查端口占用：

# Linux/macOS
lsof -i :8000
# Windows
netstat -ano | findstr ":8000"

若端口被占用，修改docker-compose.yml中的端口映射，比如改成"8001:8000"。

5. 验证docker-compose配置文件语法 #

执行命令检查配置文件是否存在语法错误：

docker-compose config

若有错误会输出具体信息，修正后重新启动服务。

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