前言

通过前面文章的介绍，我相信小伙伴们已经对 MinIO 存储服务有了一定的认识。知道 MinIO 是一款非常热门的开源对象存储服务器，能够完美兼容亚马逊的 S3 协议, 对 K8s 也能够进行非常友好的支持，专为 AI 等云原生工作负载而设计。今天我们就来聊一聊在集成 MinIO 过程中遇到的一些上传相关的问题。

常见问题

当我们开发上传功时，特别是通过分片的形式上传文件到 MinIO 存储服务会遇到各种问题。本文记录这些问题是为了便于日后回顾查看，也是为了帮助遇到相同问题的小伙伴。那么，具体都有哪些常见问题呢？下面就来详细介绍。

问题一

[Error] 2021/08/17 20:15:10 转储分片失败 Part number cannot be negative or equal to zero. minio.go 216

解决：

一般上传接口在设置分片索引时，都是从0开始，但是 MinIO 存储服务定义分片索引却是从1开始的。所以再接口参数转换时，需要加1对齐，否则在上传第一个分片的时候就会报这个错误。

问题二

[Error] 2021/08/17 20:19:12 处理文件分片失败 connection() : connection(minio.test.cn:27017[-3]) incomplete read of message header: read tcp 172.31.33.6:59048->139.227.116.36:27017: i/o timeout base.go 66

解决：

这个问题发生时是网络切换过程中出现的，wifi稳定后，再重新尝试上传，问题消失。之后分析，问题出现的原因应该是网络中断，导致数据库服务连接超时或者数据传输超时。

问题三

[Error] 2021/08/17 20:31:27 完成分片上传失败 One or more of the specified parts could not be found. The part may not have been uploaded, or the specified entity tag may not match the part’s entity tag. minio.go 238

解决：

造成该问题可能的原因有两个，一是想要合并的分片确实不存在；二是指定的分片标签不匹配。如果是前者，我们确认 uploadID 是正确的，如果是后者，我们想要校验 Tag 参数是否正确。

问题四

[Error] 2021/08/17 20:36:46 转储分片失败 Requests specifying Server Side Encryption with Customer provided keys must be made over a secure connection. minio.go 216

解决：

分片上传接口 PutObjectPart 的最后一个参数是 encrypt.ServerSide 对象，如果启用的话，必须使用 https 协议建立客户端与服务端的连接。因此，我们可以通过设置该参数为空 nil，先不启动服务加密机制。

对应 PutObjectPart 接口的源代码如下：

// PutObjectPart - Upload an object part.
func (c Core) PutObjectPart(ctx context.Context, bucket, object, uploadID string, partID int, data io.Reader, size int64, md5Base64, sha256Hex string, sse encrypt.ServerSide) (ObjectPart, error) {
	return c.uploadPart(ctx, bucket, object, uploadID, data, partID, md5Base64, sha256Hex, size, sse)
}

结尾

好了，今天关于分片上传 MinIO 存储服务的常见问题就先介绍这么多，这些问题是比较常见的。也欢迎感兴趣的小伙伴评论补充。我是 liuzhen007（Data-Mining），欢迎大家关注我，分享更多对象存储的知识。晚安～～ 😴 ！

日历打卡（8月更文挑战）