微服务间应通过统一对象存储（如s3/minio）共享文件，仅传递object_key；禁止传本地路径、文件句柄或依赖临时文件；客户端配置需严格匹配协议、证书与超时策略；测试时避免fs.fs语义陷阱。
Go 微服务里怎么安全共享文件路径
微服务之间不共享磁盘，直接传 filepath 或本地 /tmp/file.zip 路径等于扔了个炸弹——下游服务根本打不开。必须转成可寻址的抽象标识。
- 用统一对象存储（如 S3 兼容服务）做唯一文件中枢，所有服务只操作
object_key，比如"upload/20240517/abc123.pdf" - 禁止在 RPC 请求体里传
os.File、*os.File或io.Reader——gRPC 不支持流式字段以外的运行时句柄 - 如果必须走临时文件中转（如 legacy 系统调用 CLI 工具），得用带 TTL 的共享挂载（如 NFSv4 +
noac选项），且每个文件名必须含服务名+trace_id，避免冲突
Go 客户端对接 MinIO/S3 时最常错的三个配置项
90% 的 “connection refused” 或 “signature does not match” 都不是网络问题，是客户端初始化时埋的雷。
-
endpoint必须显式带协议和端口："https://minio.example.com:9000"，漏掉https://就会默认走http://localhost:80 -
secure参数必须和endpoint协议严格一致：HTTPS endpoint →secure: true；HTTP →secure: false，错配直接报InvalidAccessKeyId - MinIO 自建集群要关掉证书校验？别动
transport.TLSClientConfig.InsecureSkipVerify—— 改用minio.WithCustomTransport注入自定义http.Transport，否则 SDK 内部会覆盖你设的值
上传大文件时 Context 超时导致连接复位
Go 的 minio.PutObject 默认用传入的 context.Context 控制整个上传生命周期，但 HTTP 底层可能因单次 write 超时就断连，和你设的 context.WithTimeout 不是一回事。
- 上传前先用
ctx, cancel := context.WithTimeout(parentCtx, 30*time.Minute)，但必须同时设置minio.PutObjectOptions.Progress回调来观测进度，否则超时后 cancel 掉也没法知道卡在哪 - 对 >100MB 文件，强制启用分片上传：
minio.PutObjectOptions{PartSize: 5 * 1024 * 1024}，避免单次请求被 LB 或中间件 kill - 别信
http.DefaultClient.Timeout—— MinIO SDK 自己管连接池和 transport，得通过minio.WithCustomTransport注入带IdleConnTimeout和TLSHandshakeTimeout的 client
本地开发用 fs.FS 模拟对象存储时的边界陷阱
测试阶段用 os.DirFS("testdata") 替代 S3 很方便，但上线一跑就 panic，因为 fs.FS 和对象存储语义根本不对齐。
立即学习“go语言免费学习笔记（深入）”；
-
fs.ReadFile返回的是完整字节，而 S3 的GetObject返回的是流式io.ReadCloser—— 如果代码里做了io.Copy(ioutil.Discard, reader)后又想再读，本地 FS 能成，S3 会 EOF -
fs.Glob不支持通配符递归，"logs/**.log"在本地返回空，在 MinIO 上却能用ListObjectsV2扫出来，别用fs测目录遍历逻辑 - 权限模拟失效：本地
os.Chmod改文件权限，对对象存储毫无意义，但你的单元测试如果依赖os.IsPermission判断，就会漏掉真实环境的 ACL 错误
真正难的不是怎么连上存储，而是让每个服务都忘记“文件在哪儿”，只认 bucket 和 object_key —— 这个抽象一旦被任何一层打破，后续所有重试、审计、清理都会开始掉链子。
