# 文件上传路径说明

## 当前配置

### 文件保存路径
文件保存在项目根目录的 `front/uploads/` 目录下，按照日期自动分类：

```
项目根目录/
├── server/
│   └── controllers/
│       └── file.go  （处理上传）
├── front/
│   └── uploads/          ← 文件保存位置
│       ├── 2024/
│       │   └── 01/
│       │       └── 15/
│       │           └── 20240115143045_example.jpg
```

### 代码中的路径

在 `server/controllers/file.go` 的 `Post()` 方法中：

```go
// 构造保存路径：../front/uploads/年/月/日/
uploadDir := path.Join("..", "front", "uploads", datePath)
```

**说明**：
- `..` 表示从 server 目录向上一级到项目根目录
- `front/uploads/` 是上传文件的根目录
- `datePath` 是按日期自动生成的子目录（如 `2024/01/15`）

### 静态文件访问配置

在 `server/conf/app.conf` 中：

```conf
StaticDir = /uploads:../front/uploads
```

**说明**：
- `/uploads` 是 URL 访问路径
- `../front/uploads` 是实际文件存储路径（相对于 server 目录）

## 目录结构

### 保存到数据库的路径
- `file_path`: `uploads/2024/01/15/20240115143045_example.jpg`（相对路径）
- `file_url`: `/uploads/2024/01/15/20240115143045_example.jpg`（URL 路径）

### 实际文件系统路径
```
front/uploads/2024/01/15/20240115143045_example.jpg
```

### 访问 URL
```
http://localhost:8080/uploads/2024/01/15/20240115143045_example.jpg
```

## 为什么使用相对路径 `..`

由于项目结构是：
```
yunzer_go/
├── server/        ← 服务端代码
└── front/          ← 前端代码和上传文件
    └── uploads/
```

从 `server` 目录运行应用时，要访问 `front/uploads`，需要使用 `../front/uploads`。

## 如果路径不对怎么办？

### 方案1：修改代码中的路径
如果您的项目启动目录不同，可以修改 `file.go` 中的路径：

```go
// 如果从项目根目录运行
uploadDir := path.Join("front", "uploads", datePath)

// 或者使用绝对路径
uploadDir := path.Join("/path/to/project", "front", "uploads", datePath)
```

### 方案2：从配置文件读取
在 `app.conf` 中添加配置：

```conf
# 上传文件目录
uploadDir = ../front/uploads
```

然后在代码中读取：

```go
import "github.com/beego/beego/v2/server/web"

uploadDir := path.Join(
    web.AppConfig.String("uploadDir"),
    datePath,
)
```

## 验证路径是否正确

### 1. 检查文件保存位置
上传一个文件后，查看文件是否在正确的位置：

```bash
ls front/uploads/
```

应该看到按日期分类的文件夹和文件。

### 2. 检查数据库记录
查看 `yz_files` 表中的 `file_path` 字段：

```sql
SELECT file_path, file_url FROM yz_files ORDER BY upload_time DESC LIMIT 1;
```

应该看到类似：
```
file_path: uploads/2024/01/15/20240115143045_example.jpg
file_url: /uploads/2024/01/15/20240115143045_example.jpg
```

### 3. 检查 URL 访问
直接在浏览器访问：

```
http://localhost:8080/uploads/2024/01/15/文件名
```

如果能看到文件，说明路径配置正确。

## 常见问题

### Q: 文件保存在了 server/front/uploads？
A: 修改代码中的路径为 `../front/uploads`（已经修改）

### Q: 文件保存在了 front/front/uploads？
A: 检查当前工作目录，确保在 server 目录运行应用

### Q: 访问文件返回 404？
A: 检查 `app.conf` 中的 StaticDir 配置是否正确

### Q: 权限问题？
A: 确保应用有创建目录和写入文件的权限：
```bash
chmod 755 front/uploads
```

## 建议的改进

如果需要更可靠的路径处理，可以考虑：

1. **使用绝对路径**：从配置文件或环境变量读取项目根目录
2. **路径验证**：在应用启动时检查上传目录是否存在，不存在则创建
3. **日志记录**：记录文件保存的完整路径，便于调试