hero920103/go-platform
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

更新补号机制

Browse Source
This commit is contained in:
hero920103
2026-06-02 23:44:44 +08:00
parent e6b84aad80
commit 269fbd08ff
21 changed files with 2130 additions and 2112 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/DEPLOYMENT_CHECKLIST.md
-392
View File
@@ -1,392 +0,0 @@
# 存储功能部署检查清单
## 部署前准备
### 1. 环境检查
- [ ] Go 1.17+ 已安装
- [ ] MySQL 5.7+ 已安装并运行
- [ ] Node.js 14+ 已安装（前端）
- [ ] 网络连接正常
### 2. 依赖安装
```bash
# 后端依赖
cd go
go mod download
go mod tidy
# 前端依赖（如需要）
cd platform
npm install
```
### 3. 数据库迁移
```bash
# 备份数据库
mysqldump -u root -p your_database > backup_$(date +%Y%m%d).sql
# 执行迁移
mysql -u root -p your_database < go/migrations/add_storage_config_table.sql
# 验证表创建
mysql -u root -p your_database -e "SHOW TABLES LIKE 'yz_system_storage_config';"
mysql -u root -p your_database -e "DESC yz_system_storage_config;"
```
## 部署步骤
### 1. 后端部署
```bash
cd go
# 编译
go build -o server main.go
# 或使用bee工具
bee run
```
### 2. 前端部署
```bash
cd platform
# 开发环境
npm run dev
# 生产环境
npm run build
```
### 3. 配置验证
访问：http://localhost:8080/platform/storageConfig
预期响应：
```json
{
"code": 200,
"msg": "success",
"data": {
"storage_type": "local",
...
}
}
```
## 功能测试
### 1. 存储配置测试
#### 测试本地存储
1. 登录平台管理后台
2. 进入：系统设置 → 平台设置 → 存储配置
3. 选择"本地存储"
4. 点击"保存设置"
5. 验证保存成功
#### 测试七牛云存储
1. 准备七牛云账号和配置信息
2. 选择"七牛云存储"
3. 填写配置：
- AccessKey: `your_access_key`
- SecretKey: `your_secret_key`
- Bucket: `your_bucket`
- CDN域名: `https://cdn.example.com`
- 存储区域: `z0`
4. 点击"保存设置"
5. 验证保存成功
### 2. 文件上传测试
#### 本地存储上传
1. 配置为本地存储
2. 上传测试文件
3. 检查文件是否保存到 `uploads/` 目录
4. 验证文件URL格式：`/uploads/2024/01/01/xxx.jpg`
5. 访问文件URL，确认可以访问
#### 七牛云上传
1. 配置为七牛云存储
2. 上传测试文件
3. 检查数据库记录
4. 验证文件URL格式：`https://cdn.example.com/2024/01/01/xxx.jpg`
5. 访问文件URL，确认可以访问
### 3. 文件迁移测试
1. 准备一些本地存储的文件
2. 配置七牛云存储
3. 调用迁移API：
```bash
curl -X POST http://localhost:8080/platform/storage/migrateToQiniu
```
4. 检查迁移进度和结果
5. 验证文件URL已更新
6. 访问新URL，确认文件可访问
## 性能测试
### 1. 上传性能
```bash
# 测试单文件上传
time curl -F "file=@test.jpg" http://localhost:8080/platform/uploadfile
# 测试批量上传
for i in {1..10}; do
curl -F "file=@test$i.jpg" http://localhost:8080/platform/uploadfile &
done
wait
```
### 2. 迁移性能
- 准备100个测试文件
- 执行迁移
- 记录总耗时
- 计算平均速度
## 监控检查
### 1. 日志检查
```bash
# 查看服务日志
tail -f logs/server.log
# 查看错误日志
grep ERROR logs/server.log
# 查看上传日志
grep "文件上传" logs/server.log
```
### 2. 数据库检查
```sql
-- 检查存储配置
SELECT * FROM yz_system_storage_config;
-- 检查文件记录
SELECT COUNT(*) FROM yz_system_files;
-- 检查最近上传的文件
SELECT * FROM yz_system_files ORDER BY create_time DESC LIMIT 10;
```
### 3. 存储空间检查
```bash
# 本地存储空间
du -sh uploads/
# 七牛云存储空间（在七牛云控制台查看）
```
## 安全检查
### 1. 配置安全
- [ ] SecretKey 不在日志中输出
- [ ] 配置文件权限正确（600）
- [ ] 数据库连接使用强密码
- [ ] API接口有认证保护
### 2. 文件安全
- [ ] 文件大小限制生效（200MB）
- [ ] 文件类型验证正常
- [ ] 恶意文件上传被拦截
- [ ] 文件访问权限正确
### 3. 网络安全
- [ ] HTTPS配置正确
- [ ] CDN域名已备案
- [ ] 防火墙规则正确
- [ ] 跨域配置正确
## 回滚计划
### 如果部署失败
1. 停止服务
```bash
pkill -f server
```
2. 恢复数据库
```bash
mysql -u root -p your_database < backup_YYYYMMDD.sql
```
3. 恢复代码
```bash
git checkout previous_version
```
4. 重启服务
```bash
cd go
bee run
```
## 常见问题
### 问题1: 依赖安装失败
**解决方法:**
```bash
# 清理缓存
go clean -modcache
# 使用代理
export GOPROXY=https://goproxy.cn,direct
# 重新安装
go mod download
```
### 问题2: 数据库迁移失败
**解决方法:**
```bash
# 检查表是否已存在
mysql -u root -p your_database -e "SHOW TABLES LIKE 'yz_system_storage_config';"
# 如果存在，先删除
mysql -u root -p your_database -e "DROP TABLE IF EXISTS yz_system_storage_config;"
# 重新执行迁移
mysql -u root -p your_database < go/migrations/add_storage_config_table.sql
```
### 问题3: 七牛云上传失败
**检查项:**
- AccessKey 和 SecretKey 是否正确
- Bucket 是否存在
- 存储区域是否匹配
- 网络连接是否正常
**测试连接:**
```bash
curl -I https://your-cdn-domain.com
```
### 问题4: 文件访问404
**本地存储:**
```bash
# 检查文件是否存在
ls -la uploads/2024/01/01/
# 检查Nginx配置
nginx -t
# 检查文件权限
chmod 644 uploads/2024/01/01/*
```
**七牛云:**
- 检查CDN域名是否正确
- 检查文件是否上传成功
- 检查空间访问权限
## 部署完成确认
### 功能确认
- [ ] 存储配置页面正常显示
- [ ] 本地存储配置保存成功
- [ ] 七牛云配置保存成功
- [ ] 本地存储上传正常
- [ ] 七牛云上传正常
- [ ] 文件访问正常
- [ ] 文件迁移功能正常
- [ ] 错误处理正常
- [ ] 日志记录正常
### 性能确认
- [ ] 上传速度正常（< 5秒/10MB）
- [ ] 访问速度正常（< 1秒）
- [ ] 迁移速度正常（> 10文件/秒）
- [ ] 内存使用正常（< 500MB）
- [ ] CPU使用正常（< 50%）
### 安全确认
- [ ] 认证保护生效
- [ ] 文件大小限制生效
- [ ] 文件类型验证生效
- [ ] 敏感信息不泄露
- [ ] 日志不包含密钥
## 上线通知
### 通知内容
```
【系统升级通知】
尊敬的用户：
系统已完成存储功能升级，新增以下功能：
1. 支持七牛云存储
2. 支持存储配置管理
3. 支持文件迁移功能
升级后的优势：
- 更快的访问速度（CDN加速）
- 更高的可靠性（云端备份）
- 更低的成本（按需付费）
如有问题，请联系技术支持。
感谢您的支持！
```
## 后续优化
### 短期优化（1周内）
- [ ] 添加上传进度显示
- [ ] 添加批量上传功能
- [ ] 优化错误提示
- [ ] 添加使用统计
### 中期优化（1个月内）
- [ ] 添加图片压缩
- [ ] 添加缩略图生成
- [ ] 添加水印功能
- [ ] 添加访问统计
### 长期优化（3个月内）
- [ ] 支持更多存储服务
- [ ] 添加文件管理界面
- [ ] 添加自动备份
- [ ] 添加CDN配置
---
**部署完成后，请在此签名确认：**
- 部署人员：__________
- 部署时间：__________
- 测试人员：__________
- 测试时间：__________
- 审核人员：__________
- 审核时间：__________
docs/IMPLEMENTATION_COMPLETE.md
-404
View File
@@ -1,404 +0,0 @@
# 🎉 存储配置功能 - 完整实现报告
## 项目概述
本项目已完整实现文件存储的配置、上传和迁移功能，支持本地存储和七牛云存储的无缝切换。
## ✅ 完成的工作清单
### 1. 数据库层 (100%)
- ✅ 创建 `yz_system_storage_config` 表
- ✅ 编写数据库迁移SQL
- ✅ 添加默认配置数据
**文件:**
- `go/migrations/add_storage_config_table.sql`
### 2. 后端核心服务 (100%)
#### 存储服务抽象层
- ✅ 定义 `StorageService` 接口
- ✅ 实现 `LocalStorage` 本地存储
- ✅ 实现 `QiniuStorage` 七牛云存储
- ✅ 实现 `GetStorageService()` 自动选择
**文件:**
- `go/services/storage_service.go` (新增, 300+ 行)
**功能:**
- 统一的上传接口
- 自动MD5计算
- 支持所有七牛云区域
- 完整的错误处理
#### 文件迁移服务
- ✅ 实现并发迁移逻辑
- ✅ 实现进度跟踪
- ✅ 实现错误收集
- ✅ 实现数据库更新
**文件:**
- `go/services/storage_migration.go` (新增, 200+ 行)
**功能:**
- 5个并发迁移
- 实时进度显示
- 错误详细记录
- 自动回滚机制
### 3. 后端控制器 (100%)
#### 存储配置控制器
- ✅ 获取存储配置 API
- ✅ 保存存储配置 API
- ✅ 参数验证
- ✅ 错误处理
**文件:**
- `go/controllers/storage_config.go` (新增, 150+ 行)
#### 迁移控制器
- ✅ 迁移到七牛云 API
- ✅ 查询迁移进度 API
**文件:**
- `go/controllers/storage_migration.go` (新增, 60+ 行)
#### 文件上传控制器改造
- ✅ 集成存储服务
- ✅ 自动选择存储方式
- ✅ MD5去重检查
- ✅ 失败自动回滚
**文件:**
- `go/controllers/platform_file.go` (修改, 重构上传逻辑)
### 4. 后端模型和路由 (100%)
- ✅ 创建 `StorageConfig` 模型
- ✅ 注册模型到ORM
- ✅ 添加存储配置路由
- ✅ 添加迁移路由
**文件:**
- `go/models/storage_config.go` (新增)
- `go/models/init.go` (修改)
- `go/routers/platform/platform.go` (修改)
### 5. 依赖管理 (100%)
- ✅ 添加七牛云SDK依赖
- ✅ 更新 go.mod
- ✅ 创建依赖安装脚本
**文件:**
- `go/go.mod` (修改)
- `go/scripts/install_dependencies.sh` (新增)
- `go/scripts/install_dependencies.bat` (新增)
### 6. 前端实现 (100%)
#### API接口
- ✅ 获取存储配置接口
- ✅ 保存存储配置接口
**文件:**
- `platform/src/api/sitesettings.js` (修改)
#### 配置组件
- ✅ 存储类型切换
- ✅ 七牛云配置表单
- ✅ 表单验证
- ✅ 本地草稿保存
- ✅ 友好的提示信息
**文件:**
- `platform/src/views/system/platformsettings/components/storageSettings.vue` (新增, 250+ 行)
#### 主页面
- ✅ 添加存储配置标签页
- ✅ 集成配置组件
**文件:**
- `platform/src/views/system/platformsettings/index.vue` (修改)
### 7. 文档和脚本 (100%)
- ✅ 详细使用指南
- ✅ 实现总结文档
- ✅ 部署检查清单
- ✅ 测试脚本
- ✅ README文档
**文件:**
- `docs/storage-config-guide.md` (新增)
- `README_STORAGE.md` (新增)
- `DEPLOYMENT_CHECKLIST.md` (新增)
- `go/scripts/test_storage.sh` (新增)
- `IMPLEMENTATION_COMPLETE.md` (本文件)
## 📊 代码统计
### 新增文件
| 类型 | 文件数 | 代码行数 |
|------|--------|---------|
| Go后端 | 4 | ~800行 |
| Vue前端 | 1 | ~250行 |
| SQL | 1 | ~20行 |
| 脚本 | 3 | ~150行 |
| 文档 | 5 | ~2000行 |
| **总计** | **14** | **~3220行** |
### 修改文件
| 文件 | 修改内容 |
|------|---------|
| `go/controllers/platform_file.go` | 重构上传逻辑 |
| `go/models/init.go` | 注册新模型 |
| `go/routers/platform/platform.go` | 添加路由 |
| `go/go.mod` | 添加依赖 |
| `platform/src/api/sitesettings.js` | 添加API |
| `platform/src/views/system/platformsettings/index.vue` | 添加标签页 |
## 🎯 核心功能
### 1. 存储服务抽象
```go
type StorageService interface {
Upload(file, header) (*UploadResult, error)
GetPublicURL(key string) string
Delete(key string) error
}
```
### 2. 自动选择存储
```go
storageService, _ := services.GetStorageService()
// 根据配置自动返回 LocalStorage 或 QiniuStorage
```
### 3. 统一上传接口
```go
result, err := storageService.Upload(file, header)
// 返回统一的 UploadResult，包含URL、Key、Size、MD5
```
### 4. 文件迁移
```go
progress, err := services.MigrateLocalToQiniu(tenantID)
// 并发迁移，实时进度，错误收集
```
## 🔧 技术栈
### 后端
- Go 1.17+
- Beego v2.1.0
- 七牛云SDK v7.18.2
- MySQL 5.7+
### 前端
- Vue 3
- Element Plus
- Axios
## 📦 部署步骤
### 1. 安装依赖
```bash
cd go
go mod download
go mod tidy
```
### 2. 数据库迁移
```bash
mysql -u root -p your_database < go/migrations/add_storage_config_table.sql
```
### 3. 启动服务
```bash
cd go
bee run
```
### 4. 配置存储
访问：平台管理后台 → 系统设置 → 平台设置 → 存储配置
## 🧪 测试覆盖
### 单元测试
- [ ] 存储服务接口测试
- [ ] 本地存储上传测试
- [ ] 七牛云上传测试
- [ ] 迁移服务测试
### 集成测试
- [x] API接口测试
- [x] 文件上传测试
- [x] 配置保存测试
- [x] 前端界面测试
### 性能测试
- [ ] 上传性能测试
- [ ] 并发上传测试
- [ ] 迁移性能测试
## 📈 性能指标
### 上传性能
- 本地存储：~50MB/s
- 七牛云：~10MB/s（受网络影响）
### 迁移性能
- 并发数：5
- 速度：~10文件/秒
- 内存占用：< 100MB
## 🔒 安全特性
- ✅ 参数验证
- ✅ 文件大小限制（200MB）
- ✅ 文件类型验证
- ✅ MD5去重
- ✅ 错误处理
- ✅ 失败回滚
- ⚠️ 密钥加密（待实现）
## 🚀 扩展性
### 支持的存储类型
- ✅ 本地存储
- ✅ 七牛云存储
- ⏳ 阿里云OSS（待实现）
- ⏳ 腾讯云COS（待实现）
- ⏳ AWS S3（待实现）
### 可扩展功能
- ⏳ 图片压缩
- ⏳ 缩略图生成
- ⏳ 水印添加
- ⏳ 视频转码
- ⏳ 断点续传
- ⏳ 分片上传
## 📝 使用示例
### 配置本地存储
```javascript
{
storage_type: "local"
}
```
### 配置七牛云
```javascript
{
storage_type: "qiniu",
qiniu_access_key: "your_key",
qiniu_secret_key: "your_secret",
qiniu_bucket: "your_bucket",
qiniu_domain: "https://cdn.example.com",
qiniu_region: "z0"
}
```
### 上传文件
```go
// 自动选择存储
storageService, _ := services.GetStorageService()
result, _ := storageService.Upload(file, header)
fmt.Println(result.URL) // 完整访问URL
```
### 迁移文件
```go
progress, _ := services.MigrateLocalToQiniu(tenantID)
fmt.Printf("成功: %d, 失败: %d\n", progress.Success, progress.Failed)
```
## 🐛 已知问题
1. ⚠️ 密钥明文存储（建议加密）
2. ⚠️ 迁移进度查询未实现（需要Redis或全局变量）
3. ⚠️ 从七牛云迁移到本地未实现
## 📅 后续计划
### 短期（1周）
- [ ] 添加密钥加密
- [ ] 实现迁移进度查询
- [ ] 添加单元测试
### 中期（1个月）
- [ ] 支持阿里云OSS
- [ ] 支持腾讯云COS
- [ ] 添加图片处理功能
### 长期（3个月）
- [ ] 支持AWS S3
- [ ] 添加文件管理界面
- [ ] 添加访问统计
- [ ] 添加自动备份
## 🎓 学习资源
- 七牛云文档：https://developer.qiniu.com/
- Go SDK文档：https://github.com/qiniu/go-sdk
- Beego文档：https://beego.vip/
- Vue3文档：https://vuejs.org/
## 👥 贡献者
- 开发：AI Assistant
- 测试：待定
- 文档：AI Assistant
## 📄 许可证
本项目遵循项目原有许可证。
---
## ✨ 总结
本次实现完成了：
1. ✅ **完整的存储服务抽象层**，支持多种存储方式
2. ✅ **自动化的文件上传**，根据配置自动选择存储
3. ✅ **强大的文件迁移功能**，支持并发迁移和进度跟踪
4. ✅ **友好的配置界面**，简单易用的前端配置
5. ✅ **完善的文档**，包括使用指南、部署清单、测试脚本
**代码质量：**
- 清晰的架构设计
- 完整的错误处理
- 详细的代码注释
- 统一的代码风格
**可维护性：**
- 模块化设计
- 接口抽象
- 易于扩展
- 文档完善
**生产就绪：**
- 完整的功能实现
- 详细的部署文档
- 测试脚本
- 故障排查指南
---
**🎉 项目已完成，可以投入生产使用！**
如有问题，请参考：
- 使用指南：`docs/storage-config-guide.md`
- 部署清单：`DEPLOYMENT_CHECKLIST.md`
- 快速开始：`README_STORAGE.md`
docs/QUICK_START.md
-122
View File
@@ -1,122 +0,0 @@
# 🚀 存储配置功能 - 5分钟快速开始
## 第一步：安装依赖（1分钟）
```bash
cd go
go mod download
go mod tidy
```
## 第二步：数据库迁移（1分钟）
```bash
mysql -u root -p your_database < go/migrations/add_storage_config_table.sql
```
验证：
```bash
mysql -u root -p your_database -e "DESC yz_system_storage_config;"
```
## 第三步：启动服务（1分钟）
```bash
cd go
bee run
# 或
go run main.go
```
## 第四步：配置存储（2分钟）
### 方式1：使用本地存储（无需配置）
1. 访问：http://localhost:8080/#/system/platformsettings
2. 点击"存储配置"标签
3. 选择"本地存储"
4. 点击"保存设置"
✅ 完成！文件将保存到 `uploads/` 目录
### 方式2：使用七牛云存储
1. 访问：http://localhost:8080/#/system/platformsettings
2. 点击"存储配置"标签
3. 选择"七牛云存储"
4. 填写配置：
```
AccessKey: 你的AccessKey
SecretKey: 你的SecretKey
Bucket: 你的Bucket名称
CDN域名: https://你的CDN域名
存储区域: z0（华东）
```
5. 点击"保存设置"
✅ 完成！文件将上传到七牛云
## 测试上传
### 使用Postman测试
```
POST http://localhost:8080/platform/uploadfile
Headers:
Authorization: Bearer your_token
Body:
form-data
file: 选择文件
```
### 使用curl测试
```bash
curl -X POST \
-H "Authorization: Bearer your_token" \
-F "file=@test.jpg" \
http://localhost:8080/platform/uploadfile
```
## 常见问题
### Q1: 依赖安装失败？
```bash
export GOPROXY=https://goproxy.cn,direct
go mod download
```
### Q2: 数据库连接失败？
检查 `go/conf/app.conf` 中的数据库配置：
```ini
mysqluser = root
mysqlpass = your_password
mysqlurls = 127.0.0.1:3306
mysqldb = your_database
```
### Q3: 七牛云上传失败？
1. 检查密钥是否正确
2. 检查Bucket是否存在
3. 检查存储区域是否匹配
4. 测试网络连接：`curl -I https://你的CDN域名`
## 下一步
- 📖 阅读完整文档：`README_STORAGE.md`
- 🔧 查看部署清单：`DEPLOYMENT_CHECKLIST.md`
- 📚 查看使用指南：`docs/storage-config-guide.md`
- ✅ 查看实现报告：`IMPLEMENTATION_COMPLETE.md`
## 获取帮助
- 查看日志：`tail -f logs/server.log`
- 查看错误：`grep ERROR logs/server.log`
- 七牛云文档：https://developer.qiniu.com/
---
**🎉 恭喜！你已经完成了存储配置功能的快速开始！**
docs/README_STORAGE.md
-210
View File
@@ -1,210 +0,0 @@
# 存储配置功能 - 完整实现
## ✅ 已完成的所有工作
本项目已完整实现文件存储的配置、上传和迁移功能，支持本地存储和七牛云存储。
## 快速开始
### 1. 安装依赖
```bash
cd go
go mod download
go mod tidy
```
或使用脚本：
- Linux/Mac: `./scripts/install_dependencies.sh`
- Windows: `scripts\install_dependencies.bat`
### 2. 执行数据库迁移
```bash
mysql -u root -p your_database < migrations/add_storage_config_table.sql
```
### 3. 重启服务
```bash
bee run
```
### 4. 配置存储
访问：平台管理后台 → 系统设置 → 平台设置 → 存储配置
## 核心功能
### ✅ 1. 存储服务抽象层
**文件**: `services/storage_service.go`
- 统一的存储接口 `StorageService`
- 本地存储实现 `LocalStorage`
- 七牛云存储实现 `QiniuStorage`
- 自动选择存储服务 `GetStorageService()`
- 支持所有七牛云存储区域
### ✅ 2. 文件上传改造
**文件**: `controllers/platform_file.go`
- 自动根据配置选择存储方式
- MD5去重检查
- 失败自动回滚
- 完整的错误处理
### ✅ 3. 文件迁移功能
**文件**: `services/storage_migration.go`
- 从本地迁移到七牛云
- 并发迁移（5个并发）
- 实时进度跟踪
- 错误收集和报告
### ✅ 4. 存储配置管理
**后端**:
- `models/storage_config.go` - 数据模型
- `controllers/storage_config.go` - API控制器
**前端**:
- `platform/src/views/system/platformsettings/components/storageSettings.vue` - 配置界面
### ✅ 5. API接口
**存储配置**:
- `GET /platform/storageConfig` - 获取配置
- `POST /platform/saveStorageConfig` - 保存配置
**文件上传**:
- `POST /platform/uploadfile` - 上传文件（自动选择存储）
**文件迁移**:
- `POST /platform/storage/migrateToQiniu` - 迁移到七牛云
- `GET /platform/storage/migrationProgress` - 查询进度
## 技术实现
### 存储服务架构
```
┌─────────────────────────────────────┐
│ File Upload Controller │
│ (platform_file.go) │
└──────────────┬──────────────────────┘
│
▼
┌─────────────────────────────────────┐
│ Storage Service Interface │
│ (storage_service.go) │
└──────────┬──────────────────────────┘
│
┌──────┴──────┐
│ │
▼ ▼
┌─────────┐ ┌──────────┐
│ Local │ │ Qiniu │
│ Storage │ │ Storage │
└─────────┘ └──────────┘
```
## 七牛云配置
### 存储区域
| 区域名称 | 代码 |
|---------|------|
| 华东-浙江 | z0 |
| 华北-河北 | z1 |
| 华南-广东 | z2 |
| 北美-洛杉矶 | na0 |
| 亚太-新加坡 | as0 |
| 华东-浙江2 | cn-east-2 |
### 配置步骤
1. 注册七牛云账号
2. 创建存储空间（Bucket）
3. 获取 AccessKey 和 SecretKey
4. 配置 CDN 域名
5. 在系统中填写配置
## 文件清单
### 后端核心文件
```
go/
├── models/
│ ├── storage_config.go # 存储配置模型
│ └── init.go # 模型注册（已修改）
├── controllers/
│ ├── storage_config.go # 存储配置控制器
│ ├── storage_migration.go # 迁移控制器
│ └── platform_file.go # 文件上传（已改造）
├── services/
│ ├── storage_service.go # 存储服务（核心）
│ └── storage_migration.go # 迁移服务
├── routers/
│ └── platform/platform.go # 路由注册（已修改）
├── migrations/
│ └── add_storage_config_table.sql # 数据库迁移
├── scripts/
│ ├── install_dependencies.sh # 依赖安装（Linux/Mac）
│ └── install_dependencies.bat # 依赖安装（Windows）
└── go.mod # 依赖管理（已添加七牛云SDK）
```
## 使用示例
### 配置本地存储
```javascript
{
storage_type: "local"
}
```
### 配置七牛云存储
```javascript
{
storage_type: "qiniu",
qiniu_access_key: "your_access_key",
qiniu_secret_key: "your_secret_key",
qiniu_bucket: "your_bucket",
qiniu_domain: "https://cdn.example.com",
qiniu_region: "z0"
}
```
### 上传文件
```go
// 后端自动选择存储
storageService, _ := services.GetStorageService()
result, _ := storageService.Upload(file, header)
// result.URL 是完整的访问URL
```
### 迁移文件
```go
// 迁移到七牛云
progress, err := services.MigrateLocalToQiniu(tenantID)
fmt.Printf("成功: %d, 失败: %d\n", progress.Success, progress.Failed)
```
## 更多文档
- 详细使用指南：`docs/storage-config-guide.md`
- 部署检查清单：`docs/DEPLOYMENT_CHECKLIST.md`
- 快速开始：`docs/QUICK_START.md`
- 实现报告：`docs/IMPLEMENTATION_COMPLETE.md`
---
**所有功能已完整实现并测试通过！** 🎉
docs/storage-config-guide.md
-253
View File
@@ -1,253 +0,0 @@
# 存储配置功能说明
## 功能概述
系统支持两种文件存储方式：
1. **本地存储**：文件存储在服务器本地磁盘
2. **七牛云存储**：文件存储在七牛云对象存储服务
## 数据库变更
### 新增表
**表名**: `yz_system_storage_config`
**字段说明**:
| 字段名 | 类型 | 说明 |
|--------|------|------|
| id | bigint(20) | 主键ID |
| storage_type | varchar(20) | 存储类型: local/qiniu |
| qiniu_access_key | varchar(255) | 七牛云AccessKey |
| qiniu_secret_key | varchar(255) | 七牛云SecretKey |
| qiniu_bucket | varchar(128) | 七牛云Bucket名称 |
| qiniu_domain | varchar(255) | 七牛云CDN域名 |
| qiniu_region | varchar(50) | 七牛云存储区域 |
| create_time | datetime | 创建时间 |
| update_time | datetime | 更新时间 |
### 执行迁移
```bash
# 在MySQL中执行迁移脚本
mysql -u your_user -p your_database < go/migrations/add_storage_config_table.sql
```
## 后端实现
### 新增文件
1. **模型文件**: `go/models/storage_config.go`
- 定义 `StorageConfig` 模型
- 提供 `GetStorageConfig()` 方法获取配置
2. **控制器文件**: `go/controllers/storage_config.go`
- `GetStorageConfig`: 获取存储配置
- `SaveStorageConfig`: 保存存储配置
3. **路由注册**: `go/routers/platform/platform.go`
```go
beego.Router("/platform/storageConfig", &controllers.StorageConfigController{}, "get:GetStorageConfig")
beego.Router("/platform/saveStorageConfig", &controllers.StorageConfigController{}, "post:SaveStorageConfig")
```
### API接口
#### 获取存储配置
```
GET /platform/storageConfig
```
**响应示例**:
```json
{
"code": 200,
"msg": "success",
"data": {
"storage_type": "qiniu",
"qiniu_access_key": "your_access_key",
"qiniu_secret_key": "your_secret_key",
"qiniu_bucket": "your_bucket",
"qiniu_domain": "https://cdn.example.com",
"qiniu_region": "z0"
}
}
```
#### 保存存储配置
```
POST /platform/saveStorageConfig
```
**请求体**:
```json
{
"storage_type": "qiniu",
"qiniu_access_key": "your_access_key",
"qiniu_secret_key": "your_secret_key",
"qiniu_bucket": "your_bucket",
"qiniu_domain": "https://cdn.example.com",
"qiniu_region": "z0"
}
```
## 前端实现
### 新增文件
1. **API文件**: `platform/src/api/sitesettings.js`
- 新增 `getStorageConfig()` 方法
- 新增 `saveStorageConfig()` 方法
2. **组件文件**: `platform/src/views/system/platformsettings/components/storageSettings.vue`
- 存储配置表单组件
- 支持本地存储和七牛云存储切换
- 表单验证和数据持久化
3. **页面更新**: `platform/src/views/system/platformsettings/index.vue`
- 新增"存储配置"标签页
### 使用说明
1. 登录平台管理后台
2. 进入"系统设置" -> "平台设置"
3. 切换到"存储配置"标签页
4. 选择存储类型：
- **本地存储**：无需额外配置
- **七牛云存储**：需要填写以下信息
### 七牛云配置步骤
1. **注册七牛云账号**
- 访问 https://www.qiniu.com/
- 注册并完成实名认证
2. **创建存储空间**
- 登录七牛云控制台
- 进入"对象存储" -> "空间管理"
- 点击"新建空间"
- 填写空间名称（Bucket）
- 选择存储区域
- 设置访问控制（建议选择"公开"）
3. **获取密钥**
- 进入"个人中心" -> "密钥管理"
- 查看或创建 AccessKey 和 SecretKey
4. **配置CDN域名**
- 在存储空间详情页，进入"域名管理"
- 添加自定义域名或使用测试域名
- 完成域名备案和CNAME解析
- 获取CDN加速域名
5. **填写配置信息**
- AccessKey: 从密钥管理获取
- SecretKey: 从密钥管理获取
- Bucket: 存储空间名称
- CDN域名: 完整的域名地址（如 https://cdn.example.com）
- 存储区域: 选择创建空间时的区域
### 存储区域对照表
| 区域名称 | 区域代码 |
|---------|---------|
| 华东-浙江 | z0 |
| 华北-河北 | z1 |
| 华南-广东 | z2 |
| 北美-洛杉矶 | na0 |
| 亚太-新加坡 | as0 |
| 华东-浙江2 | cn-east-2 |
## 后续开发建议
### 文件上传服务改造
需要修改文件上传相关的代码，根据 `storage_type` 选择不同的存储方式：
```go
// 示例代码
func UploadFile(file *multipart.FileHeader) (string, error) {
cfg, _ := models.GetStorageConfig()
switch cfg.StorageType {
case "qiniu":
return uploadToQiniu(file, cfg)
case "local":
return uploadToLocal(file)
default:
return uploadToLocal(file)
}
}
```
### 七牛云SDK集成
需要安装七牛云Go SDK：
```bash
go get github.com/qiniu/go-sdk/v7
```
示例上传代码：
```go
import (
"github.com/qiniu/go-sdk/v7/auth/qbox"
"github.com/qiniu/go-sdk/v7/storage"
)
func uploadToQiniu(file *multipart.FileHeader, cfg *models.StorageConfig) (string, error) {
mac := qbox.NewMac(cfg.QiniuAccessKey, cfg.QiniuSecretKey)
putPolicy := storage.PutPolicy{
Scope: cfg.QiniuBucket,
}
upToken := putPolicy.UploadToken(mac)
// 配置上传参数
cfg := storage.Config{
Zone: &storage.ZoneHuadong, // 根据 cfg.QiniuRegion 选择
UseHTTPS: true,
UseCdnDomains: false,
}
formUploader := storage.NewFormUploader(&cfg)
ret := storage.PutRet{}
// 执行上传
err := formUploader.PutFile(context.Background(), &ret, upToken, key, localFile, nil)
if err != nil {
return "", err
}
// 返回完整URL
return cfg.QiniuDomain + "/" + ret.Key, nil
}
```
## 注意事项
1. **安全性**
- SecretKey 在数据库中明文存储，建议后续加密处理
- 生产环境建议使用环境变量或密钥管理服务
2. **成本**
- 七牛云存储和流量会产生费用
- 建议设置合理的存储策略和CDN缓存规则
3. **迁移**
- 切换存储方式时，已有文件不会自动迁移
- 需要手动迁移或保持双存储支持
4. **备份**
- 重要文件建议定期备份
- 七牛云支持跨区域备份功能
## 测试清单
- [ ] 数据库表创建成功
- [ ] 后端API接口正常
- [ ] 前端页面显示正常
- [ ] 本地存储配置保存成功
- [ ] 七牛云配置保存成功
- [ ] 表单验证正常工作
- [ ] 配置切换功能正常
- [ ] 数据持久化正常
docs/修复请求体为空问题.md
-200
View File
@@ -1,200 +0,0 @@
# 修复请求体为空问题
## 问题描述
七牛云上传成功后，保存文件记录到数据库时失败：
```
POST https://api.yunzer.cn/platform/qiniu/save 400
{"code": 400, "msg": "参数解析失败: 请求体为空"}
```
## 问题原因
Beego 框架默认不会复制请求体到 `c.Ctx.Input.RequestBody`，需要显式启用 `CopyRequestBody` 配置。
## 解决方案
### 1. 修改 go/conf/app.conf
添加配置：
```properties
# 启用请求体复制（允许多次读取请求体）
copyrequestbody = true
```
### 2. 修改 go/main.go
在代码中显式启用：
```go
func main() {
// 初始化数据库
models.Init(version.Version)
// 启用请求体复制（允许多次读取请求体）
beego.BConfig.CopyRequestBody = true // ← 新增
// 设置最大请求体大小（10MB，足够登录请求使用）
beego.BConfig.MaxMemory = 10 << 20 // 10MB
// 静态资源：映射 /uploads 到本地 uploads 目录，供前端访问上传文件
beego.SetStaticPath("/uploads", "uploads")
beego.Run()
}
```
### 3. 添加调试日志
在 `go/controllers/qiniu_upload.go` 的 `SaveFileRecord` 方法中添加日志：
```go
// 调试：打印请求体
body := c.Ctx.Input.RequestBody
fmt.Println("SaveFileRecord 请求体长度:", len(body))
fmt.Println("SaveFileRecord 请求体内容:", string(body))
```
## 重启服务
```bash
# 重启 Go 服务
systemctl restart go-api
# 查看服务状态
systemctl status go-api
# 查看日志
tail -f /www/wwwroot/api.yunzer.cn/go.log
```
## 测试步骤
1. 重启后端服务
2. 登录前端系统
3. 进入软件升级页面
4. 上传一个文件
5. 观察后端日志
### 预期日志输出
```
SaveFileRecord 请求体长度: 123
SaveFileRecord 请求体内容: {"key":"2026/04/09/xxx.exe","hash":"xxx","size":60742452,"name":"xxx.exe","mimeType":"application/x-msdownload","cate":0}
```
### 预期响应
```json
{
"code": 200,
"data": {
"url": "http://7colud.yunzer.cn/2026/04/09/xxx.exe",
"id": 123,
"name": "xxx.exe",
"key": "2026/04/09/xxx.exe"
}
}
```
## 相关配置说明
### CopyRequestBody 的作用
Beego 框架中，请求体默认只能读取一次。如果需要在多个地方读取请求体（例如中间件和控制器），需要启用 `CopyRequestBody`。
启用后，Beego 会在接收到请求时将请求体复制到 `c.Ctx.Input.RequestBody`，允许多次读取。
### 配置方式
有两种方式启用：
1. **配置文件方式** (`go/conf/app.conf`):
```properties
copyrequestbody = true
```
2. **代码方式** (`go/main.go`):
```go
beego.BConfig.CopyRequestBody = true
```
建议两种方式都配置，确保生效。
## 注意事项
### 1. 内存占用
启用 `CopyRequestBody` 会增加内存占用，因为每个请求的请求体都会被复制到内存中。
对于大文件上传，建议：
- 使用七牛云直传（不经过服务器）
- 只在需要的接口启用请求体复制
### 2. 与登录接口的兼容性
之前修复登录问题时，我们已经将登录接口改为使用 `c.Ctx.Input.RequestBody`，启用 `CopyRequestBody` 后，登录接口也能正常工作。
### 3. MaxMemory 配置
`MaxMemory` 配置控制请求体的最大大小：
```go
beego.BConfig.MaxMemory = 10 << 20 // 10MB
```
对于七牛云直传，文件不经过服务器，所以这个限制不影响大文件上传。
## 验证修复
### 1. 检查配置是否生效
重启服务后，查看日志中是否有请求体内容输出。
### 2. 测试上传功能
上传一个文件，检查：
- 七牛云上传是否成功
- 数据库记录是否保存成功
- 文件 URL 是否正确
### 3. 检查数据库
```sql
SELECT id, name, src, size, type, cate, md5, create_time
FROM system_file
ORDER BY id DESC
LIMIT 5;
```
应该能看到新上传的文件记录。
## 回滚方案
如果修复后出现其他问题，可以临时禁用：
```go
// go/main.go
beego.BConfig.CopyRequestBody = false
```
或在 `go/conf/app.conf` 中：
```properties
copyrequestbody = false
```
然后重启服务。
## 相关文件
- `go/main.go` - 主程序入口
- `go/conf/app.conf` - 配置文件
- `go/controllers/qiniu_upload.go` - 七牛云上传控制器
- `go/controllers/platform_auth.go` - 登录控制器（也使用 RequestBody）
## 更新日期
2026-04-09
docs/快速修复-请求体为空.md
-122
View File
@@ -1,122 +0,0 @@
# 快速修复：请求体为空问题
## 问题
```
POST /platform/qiniu/save 400
{"code": 400, "msg": "参数解析失败: 请求体为空"}
```
## 快速修复步骤
### 1. 重启后端服务（已修改配置）
```bash
systemctl restart go-api
```
### 2. 查看服务状态
```bash
systemctl status go-api
```
预期输出：
```
● go-api.service - Go API Server
Loaded: loaded
Active: active (running)
```
### 3. 查看日志
```bash
tail -f /www/wwwroot/api.yunzer.cn/go.log
```
### 4. 测试上传
1. 登录系统
2. 进入软件升级页面
3. 上传一个文件
### 5. 观察日志输出
应该看到：
```
SaveFileRecord 请求体长度: xxx
SaveFileRecord 请求体内容: {"key":"...","hash":"...","size":...}
```
## 已修改的文件
✅ `go/main.go` - 添加 `beego.BConfig.CopyRequestBody = true`
✅ `go/conf/app.conf` - 添加 `copyrequestbody = true`
✅ `go/controllers/qiniu_upload.go` - 添加调试日志
## 如果还是失败
### 检查 1: 服务是否重启成功
```bash
systemctl status go-api
```
如果失败，查看错误：
```bash
journalctl -u go-api -n 50
```
### 检查 2: 配置是否生效
查看日志中是否有请求体内容输出。如果没有，说明配置未生效。
### 检查 3: 前端请求是否正确
打开浏览器开发者工具，查看 Network 标签：
- 请求方法：POST
- Content-Type: application/json
- 请求体：应该有 JSON 数据
## 完整上传流程
```
1. 前端上传文件到七牛云 ✓
↓
2. 七牛云返回文件信息 ✓
{
"key": "2026/04/09/xxx.exe",
"hash": "xxx",
"size": 60742452
}
↓
3. 前端调用 /platform/qiniu/save ← 这里失败了
POST /platform/qiniu/save
Body: {
"key": "...",
"hash": "...",
"size": ...,
"name": "...",
"mimeType": "...",
"cate": 0
}
↓
4. 后端保存到数据库 ← 修复后应该成功
↓
5. 返回文件 URL
```
## 修复原理
Beego 框架默认不复制请求体，需要启用 `CopyRequestBody`：
```go
// 修复前
c.Ctx.Input.RequestBody // 空的
// 修复后（启用 CopyRequestBody）
c.Ctx.Input.RequestBody // 包含请求体数据
```
## 更新时间
2026-04-09
docs/接口文件.md
-26
View File
@@ -1,26 +0,0 @@
## 接口文件
> 约定：每新增一个对外接口，都需要在本文件登记（端/方法/路径/描述/鉴权/入出参简述）。
### platform（平台端）
| 方法 | 路径 | 描述 |
|---|---|---|
| `POST` | `/platform/login` | 平台登录 |
| `POST` | `/platform/sendLoginCode` | 发送登录验证码 |
| `POST` | `/platform/loginBySms` | 手机号验证码登录 |
| `POST` | `/platform/logout` | 平台退出登录 |
| `GET` | `/platform/login/getGeetest3Infos` | 获取极验3.0配置 |
| `GET` | `/platform/login/getGeetest4Infos` | 获取极验4.0配置 |
| `GET` | `/platform/login/getOpenVerify` | 判断是否开启登录验证 |
| `POST` | `/platform/resetPassword` | 忘记密码重置 |
| `POST` | `/platform/sendResetCode` | 发送找回密码验证码 |
#### `/platform/login` 详情
- 入参（JSON body）：`{ "username": string, "password": string }`
- 出参（JSON）：`{ "success": boolean, "token": string }`
- 说明：当前使用占位登录逻辑，仅校验非空并返回平台用户 JWT，后续接真实用户/租户表
> 其余 `/platform/*` 登录相关接口（发送验证码、极验、重置密码等）目前仅返回 `501 Not Implemented`，后续按实际需求逐步补全。
docs/立即执行-重启服务.md
-218
View File
@@ -1,218 +0,0 @@
# 立即执行：重启服务
## 修复内容
✅ 已修复日志错误（`beego.Info` → `fmt.Println`）
✅ 已启用 `CopyRequestBody` 配置
✅ 已添加调试输出
## 立即执行
### 1. 重启服务
```bash
systemctl restart go-api
```
### 2. 检查服务状态
```bash
systemctl status go-api
```
**预期输出**:
```
● go-api.service - Go API Server
Active: active (running)
```
如果显示 `failed`，查看错误：
```bash
journalctl -u go-api -n 50
```
### 3. 查看实时日志
```bash
tail -f /www/wwwroot/api.yunzer.cn/go.log
```
或者查看标准输出（调试日志会输出到这里）：
```bash
journalctl -u go-api -f
```
### 4. 测试上传
1. 打开浏览器，登录系统
2. 进入：平台管理 → 软件升级
3. 点击"新增"或"编辑"
4. 上传一个文件（建议先用小文件测试）
### 5. 观察日志
在终端中应该看到：
```
SaveFileRecord 请求体长度: 150
SaveFileRecord 请求体内容: {"key":"2026/04/09/1775732976777726699.exe","hash":"loozoz7qv9flWXsS5UldWdPX9-T_","size":60742452,"name":"xxx.exe","mimeType":"application/x-msdownload","cate":0}
```
### 6. 验证结果
**前端应该显示**:
- 上传进度条
- 上传成功提示
- 文件 URL: `http://7colud.yunzer.cn/2026/04/09/xxxxx.exe`
**数据库验证**:
```bash
mysql -u go-platform -p -h 212.64.112.158 -P 3388 go-platform
```
```sql
SELECT id, name, src, size, type, create_time
FROM system_file
ORDER BY id DESC
LIMIT 5;
```
## 完整上传流程
```
用户选择文件
↓
前端获取存储配置
storageType: 'qiniu'
↓
前端获取上传凭证
token, region: 'z2'
↓
前端直接上传到七牛云
POST https://upload-z2.qiniup.com
✓ 成功返回: {key, hash, size}
↓
前端保存文件记录
POST /platform/qiniu/save
Body: {key, hash, size, name, mimeType, cate}
↓
后端接收请求
✓ CopyRequestBody 已启用
✓ 请求体不为空
↓
后端保存到数据库
INSERT INTO system_file
↓
返回文件信息
{url, id, name, key}
↓
前端显示上传成功
```
## 如果还是失败
### 问题 1: 服务启动失败
**检查**:
```bash
journalctl -u go-api -n 50
```
**常见原因**:
- 端口被占用
- 数据库连接失败
- 配置文件错误
### 问题 2: 请求体仍然为空
**检查**:
1. 确认服务已重启
2. 查看日志中是否有 "请求体长度: 0"
3. 检查前端请求的 Content-Type 是否为 `application/json`
**解决**:
```bash
# 确保配置生效
grep -i "copyrequestbody" /www/wwwroot/api.yunzer.cn/conf/app.conf
# 应该看到
copyrequestbody = true
```
### 问题 3: 七牛云上传失败
**检查**:
- 浏览器控制台是否有 CORS 错误
- 七牛云 bucket 是否存在
- 区域配置是否正确（z2）
**解决**:
参见 `platform/docs/七牛云上传测试步骤.md`
## 调试技巧
### 1. 查看完整请求
浏览器开发者工具 → Network 标签 → 找到 `/platform/qiniu/save` 请求：
- Headers: 查看 Content-Type
- Payload: 查看请求体内容
- Response: 查看响应内容
### 2. 查看后端日志
```bash
# 实时日志
tail -f /www/wwwroot/api.yunzer.cn/go.log
# 或者查看 systemd 日志（包含 fmt.Println 输出）
journalctl -u go-api -f
```
### 3. 测试 API
使用 curl 测试：
```bash
# 获取 token（先登录）
TOKEN="your_token_here"
# 测试保存接口
curl -X POST https://api.yunzer.cn/platform/qiniu/save \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"key": "test/test.txt",
"hash": "test123",
"size": 1024,
"name": "test.txt",
"mimeType": "text/plain",
"cate": 0
}'
```
## 成功标志
✓ 服务启动成功
✓ 日志中看到请求体内容
✓ 前端显示上传成功
✓ 数据库有新记录
✓ 文件 URL 可以访问
## 下一步
上传成功后，可以：
1. 移除调试日志（`fmt.Println`）
2. 测试大文件上传
3. 测试批量上传
4. 验证文件去重功能
## 联系支持
如果问题仍然存在，请提供：
1. 服务状态输出
2. 完整的错误日志
3. 浏览器控制台截图
4. 请求和响应的详细信息
## 更新时间
2026-04-09