Ubuntu 升级后 Anki Sync Server 虚拟环境断代修复记录
背景 在系统从 Ubuntu 22.04 升级至 24.04 后,一个长期运行的 Anki Sync Server 服务无法启动。该服务基于 Python 虚拟环境(venv)运行,并通过 systemd 管理。升级完成后,systemd 显示服务反复启动失败。 本文记录一次完整的排查与修复过程,重点在于 Python 虚拟环境在系统升级后发生版本断代 的问题,以及如何在不影响业务数据的前提下,安全、可回溯地恢复服务。 本文为工程记录,已严格脱敏,不包含路径、主机名、账号或端口等可识别信息。 一、故障现象 systemd 服务状态显示: 手动执行启动脚本时,出现错误: 这表明 Python 运行环境无法找到 anki 模块。 二、初步检查:虚拟环境异常 检查虚拟环境中的 Python 解释器信息: 进一步检查虚拟环境目录结构后发现: 即: venv 中保留的是 Python 3.10 时期的库,而解释器已经切换到 Python 3.12。 这是一次典型的 虚拟环境断代问题: 三、修复策略选择 核心原则 策略 四、旧虚拟环境归档 原有虚拟环境目录包含: …