在Web开发中，图片上传与后续处理是极常见的需求。Golang凭借其高并发与简洁标准库，非常适合用来写图片接收与缩略图生成服务。下面直接给出一个完整实现思路，包含接收、校验、存储与多尺寸缩略图生成。
一、接收上传请求与基础校验
Golang的net/http包原生支持multipart/form-data解析。我们在接口中调用r.ParseMultipartForm限制内存占用，超过部分写入临时文件，避免大图直接吃光内存。随后从r.FormFile拿到文件句柄与文件头。
校验环节至少要检查内容类型与体积。通过fileHeader.Header.Get("Content-Type")判断是否为图片，并用fileHeader.Size限制上限。不要只信后缀，应读取前几个字节用image.DecodeConfig确认真实格式。
package main
import (
"fmt"
"net/http"
"io"
"os"
"path/filepath"
"image"
_ "image/jpeg"
_ "image/png"
)
func uploadHandler(w http.ResponseWriter, r *http.Request) {
// 限制内存使用为8MB，超出写磁盘临时文件
err := r.ParseMultipartForm(8 << 20)
if err != nil {
http.Error(w, "解析表单失败", http.StatusBadRequest)
return
}
file, header, err := r.FormFile("image")
if err != nil {
http.Error(w, "获取文件失败", http.StatusBadRequest)
return
}
defer file.Close()
// 基础校验：类型与大小
if header.Size > 10<<20 {
http.Error(w, "文件超过10MB", http.StatusBadRequest)
return
}
buf := make([]byte, 512)
file.Read(buf)
file.Seek(0, io.SeekStart)
contentType := http.DetectContentType(buf)
if contentType != "image/jpeg" && contentType != "image/png" {
http.Error(w, "仅支持JPEG或PNG", http.StatusBadRequest)
return
}
fmt.Println("通过校验:", header.Filename, header.Size)
}
二、图片存储方案与本地落盘
存储位置可分为本地磁盘与对象存储。小型项目直接存本地目录即可，但要注意文件名冲突与目录权限。通常使用time.Now().UnixNano()拼接随机串生成新名，并放到uploads/下按日期分目录。
下面的代码把通过校验的文件流拷贝到本地。我们用filepath.Join拼路径，并用os.MkdirAll确保父目录存在。若后续要接对象存储，只需把os.Create换为对应SDK的PutObject即可，主体逻辑不变。
func saveToLocal(file io.Reader, filename string) (string, error) {
dir := filepath.Join("uploads", "2024") // 实际可用日期动态生成
if err := os.MkdirAll(dir, 0755); err != nil {
return "", err
}
dst := filepath.Join(dir, filename)
out, err := os.Create(dst)
if err != nil {
return "", err
}
defer out.Close()
if _, err := io.Copy(out, file); err != nil {
return "", err
}
return dst, nil
}
三、使用第三方库生成缩略图
标准库只提供解码能力，缩放需借助如github.com/disintegration/imaging。它支持缩放、裁剪、水印等操作，且API直观。生成缩略图时应保持比例，常用imaging.Fill或imaging.Fit控制尺寸。
下面示例把原图解码后生成两张缩略图：一张宽度固定200的适配图，一张300x300裁剪封面。处理完用imaging.Encode按原格式写回。注意解码前要把文件重新Seek到开头，因为前面校验已读过流。
import (
"github.com/disintegration/imaging"
"image/jpeg"
"image/png"
"os"
)
func makeThumbnail(srcPath string) error {
img, err := imaging.Open(srcPath)
if err != nil {
return err
}
// 宽度200，高度按比例
thumbFit := imaging.Fit(img, 200, 200, imaging.Lanczos)
if err := imaging.Save(thumbFit, srcPath+".thumb200.jpg"); err != nil {
return err
}
// 300x300居中裁剪
thumbFill := imaging.Fill(img, 300, 300, imaging.Center, imaging.Lanczos)
out, err := os.Create(srcPath + ".cover300.png")
if err != nil {
return err
}
defer out.Close()
return png.Encode(out, thumbFill)
}
四、并发处理与接口整合
当用户上传后需要多尺寸输出，可用goroutine并行生成，用sync.WaitGroup等待全部完成。这样不会阻塞主存储流程，也充分利用多核。但要注意限制并发数，避免瞬间大量图片把CPU占满。
整合时，在上传接口里先存原图，再起协程做缩略图，最后返回原图URL与缩略图URL。如下面结构所示，我们用通道控制最大并发为3，既提速又稳资源。
func handleUpload(w http.ResponseWriter, r *http.Request) {
// 前面解析与校验省略
file, header, _ := r.FormFile("image")
defer file.Close()
newName := fmt.Sprintf("%d_%s", time.Now().UnixNano(), header.Filename)
dst, _ := saveToLocal(file, newName)
sem := make(chan struct{}, 3)
var wg sync.WaitGroup
sizes := []int{200, 400, 800}
for _, s := range sizes {
wg.Add(1)
sem <- struct{}{}
go func(size int) {
defer wg.Done()
defer func() { <-sem }()
// 根据size生成不同宽度缩略图
img, _ := imaging.Open(dst)
t := imaging.Fit(img, size, size, imaging.Lanczos)
imaging.Save(t, fmt.Sprintf("%s_%d.jpg", dst, size))
}(s)
}
wg.Wait()
fmt.Fprintln(w, "上传与缩略图处理完成")
}
五、常见误区与优化建议
一个典型误区是在接收时把整个文件读入[]byte再处理，这会让内存随图片增大而飙升。正确做法是用流式的io.Copy与按需解码。另一个误区是忽略EXIF方向，手机图可能横竖颠倒，可借助imaging之外的EXIF库先纠正。
若服务面向公网，还应限制单IP上传频率，并对原图做病毒扫描。存储层建议后续迁移到对象存储，利用CDN分发缩略图，降低本机IO压力。以上示例稍作封装，就能支撑起一个轻量图片处理后端。