文件上传
当你需要上传头像、导入文件、或接入对象存储(MinIO/OSS)时,从这里开始。
youlai-aspnet 提供统一的文件上传服务,支持多种存储类型切换,前端无需关心实现细节。本文涵盖:
- 存储类型切换与配置项
- 上传/删除接口与响应结构
- 常见生产问题与排查
存储类型
通过配置切换存储类型:
| 存储类型 | 配置值 | 说明 |
|---|---|---|
| 本地存储 | local | 存储在服务器本地文件系统 |
接口说明
上传文件
text
POST /api/v1/files
Content-Type: multipart/form-data| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| file | File | 是 | 表单文件对象 |
删除文件
text
DELETE /api/v1/files?filePath={url}配置项
json
"Oss": {
"Type": "local",
"Local": {
"StoragePath": "/data/upload",
"BaseUrl": "http://localhost:8000"
}
}| 参数 | 说明 |
|---|---|
Type | 存储类型:local |
StoragePath | 本地存储路径 |
BaseUrl | 文件访问基础 URL |
相关文件
| 文件 | 说明 |
|---|---|
Youlai.Application/File/IFileService.cs | 文件服务接口 |
Youlai.Application/File/FileService.cs | 文件服务实现 |
