档案软件升级实操全指南 前置校验+步骤拆解+风险规避完整方案

一、升级前强制前置校验（必做，否则升级失败率超80%）

1. 全量数据与环境备份

备份必须覆盖3类核心资源，所有备份文件需存放在非系统盘的独立备份目录，执行以下命令完成备份：

• 程序目录备份（默认路径/opt/archive_soft，可根据实际部署路径修改）： ```bash mkdir -p /backup/archive_$(date +%Y%m%d) tar -zcvf /backup/archive_$(date +%Y%m%d)/soft.tar.gz /opt/archive_soft ```
• MySQL数据库备份（将[数据库账号]、[数据库密码]、[档案库名]替换为实际值）： ```bash mysqldump -u[数据库账号] -p[数据库密码] [档案库名] > /backup/archive_$(date +%Y%m%d)/db.sql ```
• 用户上传附件备份（默认路径/opt/archive_attachment，可根据实际存储路径修改）： ```bash tar -zcvf /backup/archive_$(date +%Y%m%d)/attachment.tar.gz /opt/archive_attachment ```

2. 运行环境兼容性校验

先对照升级包官方说明，校验核心依赖版本，不符合的提前升级：

• JDK版本校验：执行java -version，若要求JDK11，直接通过华为开源镜像下载安装： ```bash wget https://repo.huaweicloud.com/openjdk/11.0.2/openjdk-11.0.2_linux-x64_bin.tar.gz tar -zxvf openjdk-11.0.2_linux-x64_bin.tar.gz -C /usr/local/ echo 'export JAVA_HOME=/usr/local/jdk-11.0.2' >> /etc/profile echo 'export PATH=$JAVA_HOME/bin:$PATH' >> /etc/profile source /etc/profile ```
• 数据库版本校验：若升级包要求MySQL8.0，现有版本为5.7的，需先完成数据库版本升级后再操作应用升级，禁止跨版本强制升级。

3. 升级包完整性校验

拿到升级包后必须做MD5校验，避免包损坏导致升级失败： ```bash md5sum archive_soft_v[版本号].tar.gz ``` 将输出的MD5值和官方提供的校验值对比，不一致则重新下载升级包。

二、分步升级实操流程

1. 停服与业务隔离

先切断业务接入，再停止应用服务，禁止直接杀进程升级，操作步骤：

• 修改Nginx配置，返回统一维护提示，避免用户访问报错： ```nginx server { listen 80; server_name 你的档案系统域名; location / { return 503 "系统升级中，预计1小时后恢复，请稍后访问"; } } ``` 执行nginx -s reload重载配置，确认外部访问已返回维护页。
• 停止应用服务：若用systemd管理，执行systemctl stop archive-soft，执行ps aux | grep archive-soft确认无进程残留，若有残留执行kill -9 [进程ID]清理。

2. 升级包部署

禁止直接覆盖原有程序目录，优先保留原有配置与日志文件，操作步骤：

• 解压升级包到临时目录： ```bash tar -zxvf archive_soft_v[版本号].tar.gz -C /tmp/archive_update ```
• 同步程序文件，排除配置、日志目录： ```bash rsync -av --exclude=config/ --exclude=logs/ /tmp/archive_update/ /opt/archive_soft/ ```
• 对比配置文件差异，新增配置项合并到原有配置： ```bash diff /opt/archive_soft/config/application.yml /tmp/archive_update/config/application.yml ``` 将diff输出的新增配置项复制到原有配置文件，禁止直接覆盖原有配置的数据库密码、端口、AK/SK等自定义内容。

3. 数据迁移执行

先在测试库执行升级SQL，确认无报错再在生产库执行，操作步骤：

• 升级SQL默认存放在升级包的update/sql/目录下，先导入到测试库校验： ```bash mysql -u[测试库账号] -p[测试库密码] [测试档案库名] < /tmp/archive_update/update/sql/v[版本号]_update.sql ``` 确认测试库数据无丢失、功能正常后，再执行生产库SQL导入。
• 导入完成后校验版本号：执行SQLselect version from sys_version;，确认返回值为最新版本号。

4. 服务启动与初步校验

• 启动服务：systemctl start archive-soft
• 查看启动日志：tail -f /opt/archive_soft/logs/start.log，确认出现「启动成功」字样无报错后，访问内网地址http://127.0.0.1:8080，用测试账号登录确认基础功能可正常打开。

三、升级后验证与回滚预案

1. 全量功能验证

必须覆盖4类核心场景，全部验证通过后再恢复业务接入：

• 档案录入：新建一条文书档案，上传附件、提交审核，确认流程正常、附件可预览
• 档案查询：检索升级前的历史档案，下载附件确认内容完整、数据无丢失
• 统计报表：生成上年度档案统计报表，对比升级前的报表数据，确认数值完全一致
• 权限校验：分别用普通用户、档案管理员、系统管理员账号登录，确认权限范围无变化

2. 故障回滚方案

出现任何10分钟内无法修复的故障，直接执行回滚，禁止在线长时间排查，回滚步骤：

• 停止当前运行的应用服务：systemctl stop archive-soft
• 恢复程序目录：tar -zxvf /backup/archive_xxxx/soft.tar.gz -C /opt/
• 恢复数据库：mysql -u[数据库账号] -p[数据库密码] [档案库名] < /backup/archive_xxxx/db.sql
• 恢复附件（若附件有修改）：tar -zxvf /backup/archive_xxxx/attachment.tar.gz -C /opt/
• 启动服务验证功能正常后，恢复Nginx的业务配置，重载Nginx完成回滚。

四、常见坑点规避

• 禁止跨大版本升级：比如从v1.x直接升级到v3.x，必须先升级到v2.x的最后一个稳定版，再升级到v3.x，避免数据迁移不兼容
• 升级时间必须选在业务低峰期（建议凌晨2-4点），预留足够的验证与回滚时间
• 升级完成后，备份文件至少保留7天，避免后续发现隐性数据问题无法恢复