HTTP handler 中正确传递 context 需显式传参而非依赖 r.Context() 自动穿透：multipart 解析和文件读写不监听上下文，必须用 io.CopyContext、分块 select 监听 ctx.Done()，并在取消时手动清理文件句柄和临时文件。
HTTP handler 中如何正确传递 context 到文件读写
不能直接用 r.Context() 去控制 os.File.Read 或 multipart.Reader.NextPart 的阻塞——这些操作不监听上下文，会无视超时信号卡死。必须把请求上下文作为参数显式传入后续 I/O 链路，并在每层做响应判断。
-
http.Request自带的r.Context()只对net/http内部逻辑生效（如连接中断、客户端断开），不穿透到io.Copy或os.Open - 上传处理函数（如解析 multipart、保存到磁盘）必须接受
context.Context参数，而不是复用r.Context()后就不管了 - 若需自定义超时（比如只给上传阶段 60 秒，而非整个请求生命周期），应基于
r.Context()派生新子 context：ctx, cancel := context.WithTimeout(r.Context(), 60*time.Second)
multipart 文件解析阶段如何中断读取
multipart.Reader.NextPart() 是阻塞调用，且不接受 context；但你可以用 io.LimitReader + select 包裹原始 http.Request.Body，在每次调用 NextPart 前检查 ctx.Done()。
- 不要在
for part, err := reader.NextPart(); err == nil; part, err = reader.NextPart()循环里直接读，这会跳过取消检查 - 推荐做法：把
req.Body封装成一个支持 cancel 的 reader，例如用http.MaxBytesReader限大小，再配合手动select分块读取 header - 若使用第三方 multipart 库（如
github.com/aws/aws-sdk-go/private/protocol/rest），确认它是否提供NextPartContext类方法；没有就只能自己分块 + select
大文件保存到磁盘时如何实现可中断复制
Go 1.19+ 直接用 io.CopyContext 替代 io.Copy，这是最简方案；但它只适用于 io.Reader → io.Writer 场景，不支持 ReadAt 或 mmap。
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
- 示例：
n, err := io.CopyContext(dstFile, srcReader)，当ctx.Err() != nil时立即返回错误，不会等整块读完 - 如果源是
*multipart.Part，需注意它本身不实现io.Reader的 cancel-aware 接口，所以仍要靠外层封装或缓冲读取 - 性能影响极小：每次 read 后多一次
ctx.Err()检查，对 GB 级文件吞吐下降不到 0.5% - 若需进度回调或自定义 buffer 大小（如 1MB），就得手写分块循环，在每个
read()前select监听ctx.Done()，避免 default 分支饿死取消信号
cancel 后的资源清理容易被忽略的点
context 取消只是发信号，不自动关闭文件、释放内存或 abort 连接；你必须在 ctx.Done() 分支里显式 cleanup。
立即学习“go语言免费学习笔记（深入）”；
- 已打开的
*os.File必须Close()，否则 fd 泄露；即使io.CopyContext返回 error，目标文件句柄仍处于 open 状态 - 临时文件（如
os.CreateTemp创建的）要在 defer 或 cancel 分支中os.Remove，不然磁盘悄悄占满 - 不要在多个 goroutine 里共享同一个
cancel()函数——调用一次就失效，重复调用 panic - 上传中途取消时，
http.ResponseWriter可能已写部分 header，此时不能再调用WriteHeader，需提前判断w.Header().Get("Content-Type") == ""再决定是否写错误响应
