现象
部署或运行FastGPT时,出现LP1 [MongooseError]: Connection operation buffering timed out after 10000ms的报错。部分场景下插件日志显示无法连接MongoDB,同时可能伴随Node.js的punycode模块弃用警告。此外,修改S3相关配置后仍无法正常访问存储服务。
可能原因
- MongoDB连接配置有误,或网络防火墙未开放对应端口,导致连接超时;
- S3存储的外部端点配置(STORAGEEXTERNALENDPOINT)不符合容器运行环境,使用宿主机真实IP或WSL网关IP时,容器无法识别该地址。
排查步骤
- 查看FastGPT运行日志,确认是否出现
Connection operation buffering timed out after 10000ms相关报错,同时检查插件日志的MongoDB连接状态。 - 检查防火墙配置,确认是否开放MongoDB及S3服务对应的端口(如9000端口)。
- 核对STORAGEEXTERNALENDPOINT的配置值,确认是否匹配当前运行环境。
- 检查MongoDB连接参数是否正确,确保服务正常运行且可被FastGPT访问。
解决与验证
针对MongoDB连接超时问题,需确认网络连通性、防火墙端口开放情况,同时参考官方Docker开发文档调整配置。针对S3配置异常,在WSL+Podman等容器环境中,将STORAGEEXTERNALENDPOINT修改为127.0.0.1可解决问题;Mac环境下直接使用宿主机真实IP即可正常识别。重启FastGPT服务后,查看日志无MongoDB连接超时报错,存储服务可正常访问。日志中的punycode模块弃用警告不影响核心功能,可忽略。