文件上传后不能直接将文件句柄或路径存入数据库，必须读取为字节流（如[]byte）或使用BYTEA/LONGBLOB等二进制类型；Gin中需通过c.FormFile()获取元信息，file.Open()读取内容，再安全写入数据库。
文件上传后直接存入数据库的常见误区
很多人以为 multipart.FileHeader 或 *multipart.File 本身就能“直接”塞进数据库，其实不是。数据库不认文件句柄或临时路径，它只认字节流（[]byte）或大对象类型（如 PostgreSQL 的 BYTEA、MySQL 的 LONGBLOB）。Gin 的 c.FormFile() 返回的是元信息和一个打开的文件流，你得自己读取内容。
- 不要试图把
file.Filename或file.Size单独存库就当“存了文件” - 不要依赖
file.Open()后的*os.File对象长期持有——它指向临时磁盘文件，请求结束即被清理 - 如果文件很大（比如 >10MB），一次性
io.ReadAll()可能导致内存暴涨，需按需流式处理或先落盘再哈希+入库
用 Gin 读取文件内容并写入数据库的最小可行步骤
核心是三步：接收 → 读取 → 插入。Gin 本身不处理数据库，所以重点在如何安全拿到完整字节。
// 示例：PostgreSQL + pgx + Gin
file, err := c.FormFile("file")
if err != nil {
c.AbortWithStatusJSON(400, gin.H{"error": "no file provided"})
return
}
<p>src, err := file.Open()
if err != nil {
c.AbortWithStatusJSON(500, gin.H{"error": "failed to open upload"})
return
}
defer src.Close()</p><p>data, err := io.ReadAll(src) // 小文件可用；大文件请改用 io.Copy 或分块读
if err != nil {
c.AbortWithStatusJSON(500, gin.H{"error": "failed to read file"})
return
}</p><p>_, err = db.Pool.Exec(ctx, "INSERT INTO files (name, content, size) VALUES ($1, $2, $3)",
file.Filename, data, file.Size)
if err != nil {
c.AbortWithStatusJSON(500, gin.H{"error": "failed to save to db"})
return
}
-
file.Open()必须配defer src.Close()，否则 fd 泄漏 -
io.ReadAll()适合 ≤5MB 的文件；更大请用bytes.Buffer配合io.CopyN控制单次读取量，或改走对象存储（OSS/S3） - PostgreSQL 的
BYTEA字段支持二进制，MySQL 的LONGBLOB也行，但注意 max_allowed_packet 限制
为什么不该把原始文件内容全量存数据库
这不是技术做不到，而是工程上通常不划算。
- 数据库体积膨胀快，备份/恢复变慢，主从同步延迟升高
- 无法利用 CDN、浏览器缓存、Range 请求等 HTTP 标准能力
- 查询时加载大字段拖慢其他字段读取（尤其 ORM 自动 SELECT *）
- 多实例部署时，数据库变成文件中心，丧失横向扩展性
更常见的做法是：
- 存文件到本地磁盘 / 对象存储（如 MinIO），生成唯一 key（如
uuid.NewString()） - 数据库存该 key、原始名、MIME 类型、大小、哈希（
sha256.Sum256(data)） - 提供
/files/:key路由做代理下载，或直链跳转
这样既保留溯源能力，又不绑架数据库
容易被忽略的边界情况
c.Request.ParseMultipartForm(32 没提前调，会导致 <code>c.FormFile() 返回 nil（默认只解析 32MB 内的 form） - 前端没设
enctype="multipart/form-data"，后端收不到任何文件字段
- 文件名含
../ 或空字节，不做清理直接拼路径可能触发目录穿越（虽然存数据库不涉及路径，但若后续导出仍需 sanitize）
- 同一请求里多次调
c.FormFile() 同名字段，第二次会返回 nil —— Gin 内部只 parse 一次，且流已消耗
c.Request.ParseMultipartForm(32 没提前调，会导致 <code>c.FormFile() 返回 nil（默认只解析 32MB 内的 form） enctype="multipart/form-data"，后端收不到任何文件字段 ../ 或空字节，不做清理直接拼路径可能触发目录穿越（虽然存数据库不涉及路径，但若后续导出仍需 sanitize） c.FormFile() 同名字段，第二次会返回 nil —— Gin 内部只 parse 一次，且流已消耗 真正难的不是“怎么存”，而是“存完怎么安全地取出来、校验、生命周期管理”。别让数据库变成你的临时文件服务器。
