MinIO服务端怎么快速启动（不用Docker也行）
MinIO本身是Go写的单二进制文件，Java项目里不需要“搭建服务端”——你得先让MinIO服务跑起来，Java只是客户端。别被“Java中搭建”带偏了，它不负责托管MinIO进程。
- 直接下载对应系统的
minio二进制（官网或GitHub Releases），加执行权限后一行命令就能起服务 - 常见错误：用
java -jar minio.jar——MinIO没有JAR包，这是Go程序，不是Java应用 - 启动命令示例：
./minio server ./data --console-address :9001，./data是本地磁盘路径，必须存在且有写权限 - 如果只想测试，加
--anonymous跳过账号验证；生产环境必须配MINIO_ROOT_USER和MINIO_ROOT_PASSWORD环境变量
Java客户端连MinIO报Connection refused或UnknownHostException
这基本不是Java代码问题，而是网络或配置没对上。MinIO默认监听 localhost:9000，但Java客户端常连错地址。
- 检查
MinioClient.builder()里传的 endpoint：本地启动时用"<a href="https://www.php.cn/link/b99c61acedb54c5253819b7b4f2d88c6">https://www.php.cn/link/b99c61acedb54c5253819b7b4f2d88c6</a>"，Docker里可能得换"<a href="https://www.php.cn/link/b27416b4650db0b348d5ce259521f749">https://www.php.cn/link/b27416b4650db0b348d5ce259521f749</a>"（Mac/Win）或容器IP（Linux） - 忘关防火墙或SELinux？
curl -v <a href="https://www.php.cn/link/b99c61acedb54c5253819b7b4f2d88c6/minio/health/live">https://www.php.cn/link/b99c61acedb54c5253819b7b4f2d88c6/minio/health/live</a>能通才说明服务真起来了 - 使用 Spring Boot 时，别把
minio.url配成https://...却没开TLS——MinIO默认是HTTP，强行配HTTPS会静默失败 - SDK版本要匹配服务端：MinIO Server ≥ v8.2.0 推荐用
io.minio:minio:8.5.11及以上；老版本SDK连新服务端可能报InvalidAccessKeyId（其实是签名算法不兼容）
上传文件时抛出NoSuchMethodError或ClassCastException
这是典型的依赖冲突，尤其在Spring Boot项目里混进了旧版 okhttp、jetty 或 httpclient。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- MinIO Java SDK v8.x 强依赖
okhttp:4.12.0+，但 Spring Boot 3.x 自带okhttp:4.11.0，版本差一点就可能崩 - 查依赖树：
./gradlew dependencies | grep okhttp或mvn dependency:tree | grep okhttp - 解决办法只有两个：强制升级
okhttp到 4.12.0+，或者用minio-java的 shaded 版本（minio-shaded），它把 okhttp 打进自己JAR里，不污染全局 - 不要用
minio:7.1.0这类老SDK——它基于okhttp:3.x，和现代Spring Boot完全不兼容，连build()方法签名都变了
用putObject上传大文件卡住或内存爆掉
putObject 默认把整个文件读进内存再发，几MB还行，几百MB直接OOM。这不是Bug，是设计如此。
立即学习“Java免费学习笔记（深入）”；
- 小文件（putObject(Bucket, Object, InputStream, size, type) 没问题
- 大文件（>10MB）：必须用
uploadObject（v8.5.0+）或分片上传（putObject+PutObjectArgs配stream+objectSize），否则JVM堆再大也扛不住 - 注意
InputStream必须支持 mark/reset（比如FileInputStream可以，ByteArrayInputStream行，但某些网络流不行）；否则SDK内部重试时会抛IOException: Resetting to invalid mark - 如果用 Spring
MultipartFile，别直接传file.getInputStream()，先检查是否已缓存到临时文件，否则流只能读一次
MinIO不是Java生态原生组件，它和Java项目之间隔着网络、协议、依赖、权限四层薄冰——踩错一层，错误信息就拐着弯骗你。最常被忽略的是：服务端没起来，却花两小时调Java代码。
