Supersonic项目0.9.8版本镜像升级问题解决方案

在Supersonic项目从0.9.6版本升级到0.9.8版本的过程中，部分用户反馈Web界面版本号未更新的问题。经过技术分析，这是由于旧版本残留文件导致的显示异常，需要通过完整的容器清理和重建流程解决。

问题现象

升级后Web界面仍显示为0.9.6版本，但实际运行的容器已经是0.9.8版本。这种版本显示不一致的情况通常表明前端静态资源未能正确更新。

根本原因

Docker Compose在升级时默认不会清除已挂载的卷数据，导致旧版本的lib和webapp目录残留，新版本的前端资源无法覆盖旧文件。

解决方案

执行以下完整清理和重建流程：

1. 完整停止并清理容器及关联卷：

docker compose down -v

2. 重新创建并启动容器：

docker compose up -d

技术原理

docker compose down -v命令中的-v参数会同时删除容器和其关联的匿名卷，确保：

• 旧的静态资源被彻底清除
• 新的容器能够从镜像中重新提取完整的前端文件
• 避免版本文件冲突

最佳实践建议

1. 重要数据卷应使用命名卷(Named Volume)而非匿名卷
2. 版本升级时建议先备份重要数据
3. 对于前端类应用，升级后建议强制刷新浏览器缓存(CTRL+F5)

验证方法

升级完成后，可以通过以下方式确认版本：

1. 检查容器镜像标签：docker ps查看IMAGE列
2. 浏览器无痕模式访问Web界面
3. 检查容器日志确认启动版本

通过这种彻底的清理重建方式，可以确保Supersonic项目各组件版本完全同步，避免因残留文件导致的各种兼容性问题。