Tandoor Recipes数据库升级：从PostgreSQL 11到16的完整指南

问题背景

在维护Tandoor Recipes应用时，用户遇到从PostgreSQL 11升级到16版本后，应用启动但数据丢失的问题。这通常发生在数据库迁移过程中出现配置错误或数据导入不完整的情况下。

关键问题分析

1. 数据库角色冲突：在导入数据时出现"role already exists"错误，表明数据库用户已存在但权限可能不匹配
2. 扩展缺失：全文搜索功能依赖的unaccent和pg_trgm扩展未正确创建
3. 认证配置：pg_hba.conf文件中的客户端认证设置不当导致连接问题

完整解决方案

1. 数据备份与导出

首先从旧版数据库导出完整数据：

docker exec -t tandoor_db_old pg_dumpall -U djangouser > tandoor.sql

2. 数据导入新版数据库

导入时需注意处理已有对象的冲突：

cat tandoor.sql | sudo docker exec -i tandoor_db psql postgres -U djangouser

3. 必备扩展创建

连接到新版数据库创建必要扩展：

CREATE EXTENSION IF NOT EXISTS unaccent;
CREATE EXTENSION IF NOT EXISTS pg_trgm;

4. 认证配置调整

修改pg_hba.conf的关键配置：

# 原配置可能限制连接
host all all all md5

# 修改为（临时解决方案，生产环境应谨慎）
host all all all trust

5. 服务重启

完成上述步骤后，重启数据库和应用容器使配置生效。

技术要点详解

1. pg_dumpall与psql：这两个PostgreSQL工具组合使用可实现完整的数据库迁移。pg_dumpall会备份所有数据库和全局对象，而psql用于恢复。

2. 扩展管理：

   • unaccent：提供去除重音符号的文本搜索功能
   • pg_trgm：支持三元组相似度搜索，增强食谱搜索体验

3. 认证安全：

   • md5：要求密码加密认证
   • trust：允许无密码连接（仅限测试环境）
   • 生产环境推荐使用peer或cert认证方式

最佳实践建议

1. 迁移前验证：

   • 检查备份文件完整性
   • 在测试环境先行验证迁移过程

2. 权限管理：

   • 确保应用数据库用户(djangouser)具有足够权限
   • 考虑使用专用迁移用户执行升级操作

3. 监控与回滚：

   • 迁移后立即验证数据一致性
   • 保留旧数据库容器直至确认新系统稳定

总结

PostgreSQL大版本升级需要特别注意数据迁移的完整性和应用兼容性。通过系统化的备份、验证和配置调整，可以确保Tandoor Recipes这类依赖数据库的应用平稳过渡。记住在生产环境中，安全配置和权限管理同样重要，临时解决方案应在验证后及时调整为更安全的永久配置。