各版本升级索引

本文档提供 Forge Admin 各版本之间的升级指南，帮助你平滑迁移。

升级路径概览

v0.8.0 (Beta) → v0.9.0 (RC) → v1.0.0 (正式版) → v1.1.0 (未来)

源版本	目标版本	难度	需要数据库迁移	需要配置变更
v0.8.0	v0.9.0	中	✅ 是	✅ 是
v0.9.0	v1.0.0	低	✅ 是	❌ 否
v1.0.0	v1.0.1	极低	❌ 否	❌ 否

---

v0.9.0 → v1.0.0

数据库迁移

1. 备份当前数据库

mysqldump -u root -p forge_admin > backup_v090.sql

2. 执行迁移脚本

# 执行 Flyway 迁移（自动）
java -jar forge-admin.jar --spring.profiles.active=prod

# 或手动执行
mysql -u root -p forge_admin < sql/v0.9.0_to_v1.0.0.sql

主要变更

变更项	说明	影响
工作流模块重构	Flowable 版本升级	需重新部署流程定义
代码生成器模板更新	新增前端模板	无影响，按需重新生成
API 加解密注解优化	密钥配置路径变更	需更新 application.yml

代码变更

• 检查自定义实现的 SaTokenInterceptor 是否需要适配
• 如有自定义 DataScopeInterceptor 实现，请对照接口变更调整

---

v0.8.0 → v0.9.0

数据库迁移

# 执行迁移脚本
mysql -u root -p forge_admin < sql/v0.8.0_to_v0.9.0.sql

主要变更

变更项	说明
系统管理模块上线	新增 sys_config、sys_dict_* 等表
日志模块上线	新增 sys_oper_log、sys_logininfor 表
文件存储模块上线	新增 file_storage 配置项

配置变更

# 新增文件存储配置
file:
  storage:
    type: minio
    endpoint: http://localhost:9000
    accessKey: minioadmin
    secretKey: minioadmin

---

通用升级步骤

无论哪个版本升级，请遵循以下步骤：

1. 备份数据库：mysqldump -u root -p forge_admin > backup_$(date +%Y%m%d).sql
2. 备份代码：git stash 或创建分支
3. 更新代码：git pull origin main
4. 更新依赖：mvn clean install -DskipTests
5. 执行迁移：启动服务，Flyway 自动执行数据库迁移
6. 验证功能：使用默认账号 admin/123456 登录验证
7. 更新前端：pnpm install && pnpm build

⚠️ 生产环境升级前，务必在测试环境完整验证一遍。