[Question] BE can’t connect to minio when changing port

快速结论：此报错通常出现在用户在开发环境（dev-env）中修改 MinIO 默认端口后，后端（BE）因配置不一致而无法连接 MinIO。优先排查 /docker/.env、docker/service_conf.yaml（或 template）以及 docker-compose 文件中 MinIO 端口是否全部同步修改。

问题场景

用户在 RAGFlow 开发环境中尝试修改 MinIO 端口，并在 /docker/.env 文件中进行了配置更改，之后发现后端无法连接到 MinIO，服务运行异常。

报错原文

[Question] BE can't connect to minio when changing port

原因分析

可能原因是 MinIO 端口在以下三处配置文件中未保持一致性：

/docker/.env 中的 MINIO_PORT 变量
docker/service_conf.yaml.template（或实际使用的 service_conf.yaml）中的 MinIO 端口配置
docker-compose 文件中 MinIO 服务的 ports 映射部分

若三者端口号不统一，后端将无法正确连接 MinIO。此外，仅修改一处并重新启动容器，也可能导致配置未完全生效。

环境排查

确认当前运行的 MinIO 容器状态：使用 docker ps 查看容器是否正在运行。
检查 MinIO 容器日志：使用 docker logs <minio-container-name> 定位连接错误信息。
核实以下文件中所有 MinIO 端口配置是否完全一致：
- /docker/.env
- docker/service_conf.yaml.template 或 docker/service_conf.yaml
- docker-compose 文件中 MinIO 服务的 ports 字段

解决步骤

打开并编辑 /docker/.env 文件，将 MINIO_PORT 变量设置为您期望的新端口。
打开并编辑 docker/service_conf.yaml.template 文件（如果已生成 service_conf.yaml 则编辑该文件），将 MinIO 相关配置中的端口号同步修改为与 .env 文件一致的值。
打开 docker-compose 文件，找到 MinIO 服务的 ports 定义部分，将映射的宿主机端口修改为与上一步相同的端口号。
执行 docker compose down 停止所有服务。
执行 docker compose up -d 重新启动所有容器，确保 MinIO 容器和后端容器都重新加载新配置。
使用 docker ps 确认 MinIO 容器正常运行，并通过 docker logs <minio-container-name> 查看日志确认无连接错误。

可优先尝试：上述步骤中确保三处端口完全一致的修改并重启，是解决该问题最直接的优先尝试方案。

验证方法

依次确认：

MinIO 容器处于“Up”状态且 health check 正常。
后端（BE）日志中没有连接 MinIO 失败的报错信息。
RAGFlow 服务能够正常上传/下载文件，无存储相关异常。

参考来源

infiniflow/ragflow Issue #8821

AI 工具推荐

想把多个 AI 模型放在一个入口？

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。

[Question] BE can’t connect to minio when changing port