Archery版本升级后系统信息显示异常的解决方案

问题现象

在使用Docker部署的Archery数据库管理平台中，当用户从v1.10.0版本升级到v1.11.1后，发现系统信息页面仍然显示为v1.10.0版本。这种情况虽然不影响系统功能，但会给用户带来版本识别上的困扰。

问题原因分析

经过技术排查，发现该问题是由于Docker容器中的版本信息文件未随升级自动更新所致。具体表现为：

1. 系统版本信息存储在/opt/archery/archery/__init__.py文件中
2. 该文件中的version变量仍保持为旧版本(1, 10, 0)
3. 系统升级过程中，这个核心版本标识文件未被正确更新

解决方案

对于遇到此问题的用户，可以按照以下步骤手动修正版本信息：

1. 进入Archery的Docker容器：

   docker exec -it archery bash
   

2. 编辑版本信息文件：

   vi /opt/archery/archery/__init__.py
   

3. 修改文件内容为：

   version = (1, 11, 1)
   display_version = ".".join(str(i) for i in version)
   

4. 保存文件后，无需重启服务，刷新页面即可看到正确的版本信息

技术背景

在Python项目中，版本号通常通过__init__.py文件中的变量来定义。Archery采用了这种标准做法，但Docker部署方式下的自动升级流程可能未能覆盖这个核心文件的更新。这种情况在Python项目的容器化部署中并不罕见，特别是在使用自定义Docker镜像时。

预防措施

为避免今后出现类似问题，建议：

1. 在升级前备份重要配置文件
2. 检查版本变更日志，了解可能涉及的配置文件改动
3. 考虑在Dockerfile中加入版本文件校验步骤
4. 对于生产环境，建议在升级后进行全面的功能验证

总结

版本信息显示异常虽然是小问题，但反映了部署流程中可能存在的不足。通过手动修正版本文件可以快速解决问题，同时也提醒我们在进行系统升级时需要关注配置文件的同步更新。对于Archery这样的数据库管理平台，保持准确的版本信息对于故障排查和系统维护都具有重要意义。