TandoorRecipes数据库迁移问题的分析与解决

问题现象

在使用Docker部署TandoorRecipes时，用户遇到了一个典型问题：每次重启应用容器后，系统都会重新执行数据库迁移操作，导致之前创建的管理员账户和添加的食谱数据全部丢失。从日志中可以看到完整的迁移过程，所有表都被重新创建。

原因分析

这个问题本质上是一个Docker数据持久化配置错误。具体来说：

1. 数据卷配置不当：用户虽然为PostgreSQL数据库配置了数据卷挂载(/data/postgres:/var/lib/postgresql/data)，但可能由于权限问题或路径配置错误，导致数据库无法真正持久化。

2. PGDATA环境变量冲突：用户设置了PGDATA: /var/lib/postgresql/data/pgdata，这个路径与挂载卷路径存在潜在冲突。

3. 应用层数据丢失：由于数据库没有真正持久化，每次容器重启都会从一个全新的PostgreSQL实例开始，触发Django的迁移机制。

解决方案

正确的数据持久化配置

对于PostgreSQL容器，推荐以下两种配置方式：

方案一：使用命名卷

volumes:
  - postgres_data:/var/lib/postgresql/data

方案二：使用绑定挂载（确保目录存在且权限正确）

volumes:
  - /path/to/local/data:/var/lib/postgresql/data

关键配置要点

1. 移除PGDATA覆盖：除非有特殊需求，否则不建议覆盖PostgreSQL默认的PGDATA路径。

2. 目录权限：确保宿主机目录对Docker容器内的postgres用户可写（通常需要设置为UID/GID 999）。

3. 验证持久化：可以通过简单的测试验证数据是否真正持久化：

   • 创建测试数据
   • 停止并删除容器
   • 重新启动容器
   • 检查测试数据是否存在

深入理解

Django迁移机制

Django的迁移系统会在以下情况下执行：

1. 检测到新的迁移文件
2. 数据库表结构与迁移记录不匹配
3. 数据库为空（如本例情况）

Docker数据持久化原理

Docker提供了几种数据持久化方式：

• 绑定挂载(Bind Mount)：直接映射宿主机目录
• 卷(Volume)：由Docker管理的持久化存储
• 临时文件系统(tmpfs)：仅内存存储（不适用本例）

最佳实践建议

1. 生产环境部署：

   • 使用Docker卷而非绑定挂载，便于备份和迁移
   • 定期备份数据库卷
   • 考虑使用数据库备份工具如pg_dump

2. 开发环境调试：

   • 可以在docker-compose中添加command: tail -f /dev/null临时保持容器运行
   • 使用docker exec进入容器检查数据库状态

3. 监控与日志：

   • 监控PostgreSQL容器的启动日志
   • 检查Django的迁移历史表(django_migrations)

通过正确配置数据持久化，可以确保TandoorRecipes应用数据在容器重启后不会丢失，为用户提供稳定的使用体验。