故障排查GitHub issue2 分钟阅读排错/错误码

解决FastGPT部署运行中MongoDB连接超时与S3配置异常问题

部署或运行FastGPT时,出现LP1 [MongooseError]: Connection operation buffering timed out after 10000ms的报错。部分场景下插件日志显示无法连接MongoDB,同时可能伴随Node.js的punycode模块弃用警告。

现象

部署或运行FastGPT时,出现LP1 [MongooseError]: Connection operation buffering timed out after 10000ms的报错。部分场景下插件日志显示无法连接MongoDB,同时可能伴随Node.js的punycode模块弃用警告。此外,修改S3相关配置后仍无法正常访问存储服务。

可能原因

  1. MongoDB连接配置有误,或网络防火墙未开放对应端口,导致连接超时;
  2. S3存储的外部端点配置(STORAGEEXTERNALENDPOINT)不符合容器运行环境,使用宿主机真实IP或WSL网关IP时,容器无法识别该地址。

排查步骤

  1. 查看FastGPT运行日志,确认是否出现Connection operation buffering timed out after 10000ms相关报错,同时检查插件日志的MongoDB连接状态。
  2. 检查防火墙配置,确认是否开放MongoDB及S3服务对应的端口(如9000端口)。
  3. 核对STORAGEEXTERNALENDPOINT的配置值,确认是否匹配当前运行环境。
  4. 检查MongoDB连接参数是否正确,确保服务正常运行且可被FastGPT访问。

解决与验证

针对MongoDB连接超时问题,需确认网络连通性、防火墙端口开放情况,同时参考官方Docker开发文档调整配置。针对S3配置异常,在WSL+Podman等容器环境中,将STORAGEEXTERNALENDPOINT修改为127.0.0.1可解决问题;Mac环境下直接使用宿主机真实IP即可正常识别。重启FastGPT服务后,查看日志无MongoDB连接超时报错,存储服务可正常访问。日志中的punycode模块弃用警告不影响核心功能,可忽略。

来源: FastGPT GitHub issue #6329