RAGFlow 0.17.2 用官方 compose 起服务，传 PDF 后解析任务失败，日志是 Minio PutObject failed: Connection refused，ragflow 容器显示 Up，minio 也显示 Up。
排查方向其实有限，先把可能性排一排。minio 容器起来了但健康检查没过，端口没真正监听；ragflow 不在同一个 docker 网络，minio 主机名解析不到；.env 里改了 MINIO_PORT，compose 的端口映射没跟着改；数据盘写满，minio 拒绝写入并断开连接。
第一件事是看各容器状态和健康检查
docker compose ps进 ragflow 容器验证 minio 的域名和端口
docker compose exec ragflow curl -sv http://minio:9000/minio/health/live然后看 minio 自己的日志有没有报错
docker compose logs --tail 100 minio末了核对 .env 与 compose 里的端口变量
docker compose config | Select-String -Pattern "MINIO|9000"命令输出我都留了记录，免得改完记不清原来的值。
改之前先确认了最近有没有人动过配置，避免白查一遍。
这次没动代码，只在配置和运行环境上找原因。
别只看报错消失，验证要多做一步。解析任务状态从 failed 变成 success，minio 日志出现 PutObject 200，知识库能检索到 PDF 里的段落。
提醒一点。这类连接失败九成在主机名和端口两处，容器 Up 只代表进程在跑，健康检查通过才算可用。这类问题最好一次改到位，反复小改反而容易把原因搅混。