yunzer_go/server/docs/UPLOAD_PATH.md

文件上传路径说明

当前配置

文件保存路径

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

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

代码中的路径

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

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

说明：

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

静态文件访问配置

在 server/conf/app.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 中的路径：

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

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

方案2：从配置文件读取

在 app.conf 中添加配置：

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

然后在代码中读取：

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

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

验证路径是否正确

1. 检查文件保存位置

上传一个文件后，查看文件是否在正确的位置：

ls front/uploads/

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

2. 检查数据库记录

查看 yz_files 表中的 file_path 字段：

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: 确保应用有创建目录和写入文件的权限：

chmod 755 front/uploads

建议的改进

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

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