使用Apache NiFi向MinIO存储上传文件时报XML解析错误如何解决？

这个XML解析错误本质是AWS S3 SDK收到了非标准S3响应格式的返回内容，无法完成解析，触发报错的常见原因如下：

• 桶名配置错误：你报错中出现的路径为/test，说明你在PutS3Object的Bucket字段填写了带前缀斜杠的/test，而非正确的test，导致请求路径异常，Minio返回错误页（多为HTML格式），SDK无法解析为预期的XML结构。
• 访问风格配置错误：PutS3Object默认使用虚拟主机风格访问（格式为{bucket}.{endpoint}），本地部署的Minio通常没有配置对应虚拟主机域名解析，会导致请求失败返回非预期响应。
• 签名版本不匹配：Minio默认使用V4版本签名，低版本NiFi的PutS3Object默认使用V2版本签名，签名校验失败后Minio返回的错误响应不符合SDK预期的XML格式。
• 区域/Endpoint配置错误：Endpoint地址填写错误、携带了桶名后缀，或者Region字段和Minio配置的区域不匹配，都会触发Minio返回异常响应。

按如下步骤修改PutS3Object处理器配置即可：

1. 基础访问配置

• Access Key ID：填写Minio生成的访问密钥
• Secret Access Key：填写Minio生成的密钥密码
• Bucket：填写test（去掉所有前缀斜杠）
• Endpoint Override URL：填写Minio服务的完整访问地址，比如http://192.168.3.20:9000，末尾不要加任何路径后缀

2. 兼容配置

• Use Path Style Access：设置为true，强制使用路径风格访问，适配本地Minio部署
• Signature Version：选择v4，对齐Minio默认的签名规则
• Region：如果Minio未自定义区域则填写us-east-1，自定义过就填对应区域名

3. 可选优化配置
   如果你的测试文件小于100MB，可以直接关闭分片上传避免额外校验：将Multipart Upload Threshold设置为大于你测试文件大小的数值，比如200 MB。

配置修改生效后，重新启动处理器：

• 若处理器没有报错，FlowFile被标记为成功，直接去Minio的test桶下查看生成的测试文件即可
• 若仍报错，可在NiFi部署节点执行curl http://{你的Minio地址}:9000/test，确认返回内容为标准XML格式，而非403/404的HTML页面，排查网络、权限问题。

对应报错原文：
Error checking S3 Multipart Upload list for /test: Failed to parse XML document with handler class com.amazonaws.services.s3.model.transform.XmlResponsesSaxParser$ListMultipartUploadsHandler

内容的提问来源于stack exchange，提问作者techNerd