wger项目数据库迁移失败导致500错误的解决方案

问题现象

在使用wger健身管理系统的自托管版本时，用户访问页面时遇到了HTTP 500服务器错误。通过检查PostgreSQL数据库日志，发现系统尝试查询一个不存在的"exercises_translation"表，同时还有关于"core_userprofile"表中缺失"weight_rounding"字段的错误。

问题分析

这类错误通常发生在Django项目数据库结构更新后，但相应的数据库迁移(migration)没有正确执行的情况下。wger作为一个持续开发的项目，随着功能迭代会不断修改数据库结构，这些变更通过迁移文件记录，需要显式地应用到数据库中。

从日志中可以明确看出两个关键问题：

1. 系统尝试查询"exercises_translation"表，但该表不存在
2. "core_userprofile"表中缺少"weight_rounding"字段

这些都是典型的数据库迁移未完成的症状。在Django项目中，当模型(Model)发生变化时，开发者会创建迁移文件，这些文件需要被执行才能将变更应用到实际数据库中。

解决方案

对于Docker部署的用户

如果使用Docker部署wger，最简单的解决方案是设置环境变量DJANGO_PERFORM_MIGRATIONS=True，这样容器启动时会自动执行未完成的迁移。这是推荐的做法，可以确保每次更新后数据库结构都能同步更新。

对于非Docker部署的用户

对于手动部署的用户，需要执行以下命令来应用未完成的迁移：

python3 manage.py migrate

这个命令会检查所有未应用的迁移文件，并按顺序执行它们，将数据库结构调整到与代码一致的状态。

最佳实践建议

1. 定期检查迁移状态：在更新wger版本后，建议检查迁移状态，可以使用命令：

   python3 manage.py showmigrations
   

2. 备份数据库：在执行迁移前，特别是大版本升级时，建议先备份数据库，以防迁移过程中出现问题。

3. 关注更新日志：wger项目更新时可能会引入新的配置选项，建议定期查看更新日志和配置文件的变化。

4. 自动化迁移：对于生产环境，建议配置自动化迁移流程，或者在部署脚本中加入迁移步骤，避免人为遗漏。

总结

数据库迁移是Django项目维护中的重要环节，wger作为一个活跃开发的项目，会不断引入数据库结构的变更。通过正确配置和执行迁移，可以避免因数据库结构不匹配导致的500错误。对于Docker用户，启用自动迁移是最简便的方案；对于手动部署用户，则需要养成在更新后执行迁移的习惯。