解决 MinIO 上传文件时报 S3 API Requests must be made to API port错误

在使用 MinIO 进行文件上传时，我遇到了一个比较坑的问题。错误日志如下：

io.minio.errors.InvalidResponseException: Non-XML response from server. Response code: 400, Content-Type: text/xml; charset=utf-8, body: <?xml version="1.0" encoding="UTF-8"?><Error><Code>InvalidArgument</Code><Message>S3 API Requests must be made to API port.</Message><RequestId>0</RequestId></Error>
	at io.minio.S3Base.execute(S3Base.java:577)
	at io.minio.S3Base.getRegion(S3Base.java:691)
	at io.minio.S3Base.execute(S3Base.java:464)
	at io.minio.S3Base.executeHead(S3Base.java:725)
	at io.minio.MinioClient.bucketExists(MinioClient.java:1135)
	at com.sky.service.impl.FileServiceImpl.upload(FileServiceImpl.java:31)
	at com.sky.controller.admin.FileUploadController.upload(FileUploadController.java:31)
	at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke0(Native Method)

问题原因

S3 API 请求必须发送到 API 端口，而不是其他端口

在 MinIO 中有两类端口：

• API 端口：用于 S3 协议的文件上传下载

• Console（Web UI）端口：用于浏览器访问管理界面

如果在代码中配置了 Console 端口，MinIO 会直接拒绝请求，并返回这个错误

我的错误配置

检查项目的配置文件 application.yml，发现我写的是 9000 端口：

minio:  
  endpoint: http://127.0.0.1:9000  
  access-key: root  
  secret-key: 12345678  
  bucket-name: lease

而 9000 其实是 Web 控制台端口，不是 API 端口:

查找的正确端口

打开运行 MinIO 的终端，可以看到启动信息里明确写了 API 和 WebUI 的端口：

可以看到：

• API 端口是 9005

• WebUI 端口是 9000

解决方案

将 application.yml 中的端口改成 API 端口即可：

minio:  
  endpoint: http://127.0.0.1:9005  
  access-key: root  
  secret-key: 12345678  
  bucket-name: lease

修改配置后重新运行项目，文件上传成功 ✅: