上传接口必须校验文件类型和大小，使用content-type与http.detectcontenttype双重验证图片mime类型，限制单文件≤5mb；用uuid生成安全文件名并防范路径遍历；返回带host的可访问http url，且需配置static路由与maxmultipartmemory。
上传接口必须校验文件类型和大小
图床最常被滥用为上传任意文件，不加限制会导致磁盘爆满或执行恶意脚本。Gin 的 c.FormFile 只负责读取 multipart 文件句柄，不自动拦截危险类型。
- 务必在调用
c.FormFile("file")后立即检查Header.Header.Get("Content-Type")，只放行image/jpeg、image/png、image/gif等真实图片 MIME 类型，别信扩展名 - 用
file.Size限制单文件 ≤5MB（例如：if file.Size > 5*1024*1024 { c.AbortWithStatusJSON(400, gin.H{"error": "file too large"}) }） - 注意：浏览器可能伪造 Content-Type，所以还得用
net/http/sniff对前 512 字节做 MIME 探测，http.DetectContentType返回非image/开头就直接拒绝
保存文件时避免路径遍历与覆盖冲突
用户传来的原始文件名（file.Filename）不可直接拼进路径，否则可能通过 ../../etc/passwd 写入任意位置，或用同名文件覆盖已有资源。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 丢弃原始文件名，用
uuid.New().String()生成唯一 ID，再拼上后缀（从探测出的 MIME 类型推导，如image/png → ".png"） - 保存路径建议固定为
./uploads/{year}/{month}/{uuid}.ext，既防冲突又利于按月归档 - 写入前用
os.Stat检查目标路径是否存在——不是为了提示“文件已存在”，而是防止 UUID 碰撞（极小概率），此时应重试生成新 UUID
返回 JSON 响应要带可访问的 URL 而非本地路径
API 返回 /uploads/2024/06/abc123.png 这种本地路径毫无意义，前端无法直接加载。必须转换成对外可访问的 HTTP 地址。
- 不要硬编码域名，从请求头提取
c.Request.Host，再结合配置的协议（c.Request.URL.Scheme或默认"https"）拼接 - 示例：
url := fmt.Sprintf("%s://%s%s", scheme, c.Request.Host, "/static/"+relPath)，其中relPath是相对 uploads 目录的路径 - 确保 Gin 已注册静态文件路由：
r.Static("/static", "./uploads")，且目录权限允许 Web 服务进程读取
忽略 Content-Length 导致超大文件阻塞请求
没设限的 multipart 表单上传，客户端可能发一个 2GB 的文件，Gin 默认会把整个 body 缓存进内存，OOM 或超时是必然结果。
- 在初始化 Gin 引擎后立即设置：
r.MaxMultipartMemory = 8 ，超过此值的文件上传会直接报错 - 配合 Nginx 使用时，还需同步配置
client_max_body_size 8M，避免请求根本到不了 Go 进程 - 注意：这个限制对所有 multipart 请求生效，如果后续要支持其他类型上传（如 ZIP），得单独拆路由或动态调整
file.Open() 后要 defer f.Close()，会导致句柄泄漏。大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
