问题背景
最近在部署一个前后端分离的应用时遇到了一个有趣的问题：使用 Docker Compose 部署时一切正常，但当使用独立的 Docker Run 命令部署时，后端无法正确访问数据。本文将详细讲解问题的排查过程和最终解决方案。
初始配置
Docker Compose 配置
services:backend:build: ./backendports:- "8000:8000"volumes:- ./backend:/backendenvironment:- DATABASE_URL=sqlite:///./test.dbnetworks:- app-networkfrontend:build:context: ./frontendports:- "3000:3000"networks:- app-networknetworks:app-network:driver: bridge
独立的 Docker Run 命令
docker run -d -p 8000:8000 --name backend --network app-network backend-image
docker run -d -p 3000:3000 --name frontend --network app-network frontend-image
问题表现
当使用独立的 Docker Run 命令启动时，后端服务返回错误：
Number of stations with data: 0
Station coordinates shape: (0,)
Latest flows: []
Error: too many indices for array: array is 1-dimensional, but 2 were indexed
问题排查过程
1. 网络连接排查
首先确认是否是容器间网络通信问题。通过创建自定义网络解决：
docker network create app-network
2. 数据库连接排查
检查数据库连接配置：
SQLALCHEMY_DATABASE_URL = os.getenv("DATABASE_URL", "sqlite:///./test.db")
发现默认配置是正确的。
3. 文件系统对比
对比两种部署方式下的文件系统差异：
# Docker Compose (正常工作)
-rwxrwxrwx 1 root root 800MB ... test.db# Docker Run (不工作)
-rw-r--r-- 1 root root 106KB ... test.db
这个关键的发现揭示了问题的本质：
- Docker Compose 通过 volume 挂载使用了宿主机的完整数据库文件
- Docker Run 使用的是镜像中的数据库文件，而这个文件明显不完整
4. 根本原因分析
检查项目的 .dockerignore 文件，发现其中包含：
*.db
这导致构建镜像时忽略了数据库文件。
解决方案
-
修改
.dockerignore，移除*.db配置 -
重新构建镜像，确保数据库文件被正确打包
-
使用简化的部署命令：
# 创建网络
docker network create app-network# 启动后端
docker run -d -p 8000:8000 --name backend --network app-network backend-image# 启动前端
docker run -d -p 3000:3000 --name frontend --network app-network frontend-image
关键经验总结
-
Docker Compose vs Docker Run 的关键差异
- Compose 可以通过 volume 轻松挂载宿主机文件
- Run 命令依赖镜像中打包的文件
- 使用 Run 命令时需要确保镜像包含所有必要文件
-
文件打包注意事项
- 注意
.dockerignore的配置 - 大文件也需要考虑是否打包进镜像
- 权衡文件打包和外部挂载的利弊
- 注意
-
最佳实践建议
- 开发环境可以使用 volume 挂载以提高灵活性
- 生产环境最好将所有必要文件打包进镜像
- 提供清晰的部署文档，说明所有必要步骤
结论
这个案例展示了 Docker 不同部署方式的细微差别。虽然 Docker Compose 提供了更便捷的开发体验，但在生产环境中，我们需要确保镜像的完整性和独立性。最终的解决方案 - 将数据库文件打包进镜像 - 不仅解决了问题，还提供了更好的可移植性和部署简便性。
