现象
仅修改docker-compose.yml中fastgpt和mysql的端口后,在Windows系统使用Chrome浏览器(已关闭浏览器翻译功能)完成FastGPT部署。新建工作流并点击进入对应页面后,隔一段时间自动退出,页面弹出未捕获异常提示。打开浏览器控制台后,可见重复的TypeError: Cannot read properties of undefined (reading 'includes')报错,同时伴随客户端异常提示。
可能原因
根据页面提示与报错信息,可能的原因分为两类:1. 私有部署场景下docker-compose.yml配置文件存在错误,该情况占私有部署用户异常的90%;2. 系统环境与FastGPT相关API存在兼容性问题。
排查步骤
- 确认已关闭浏览器翻译功能,重新访问工作流页面,验证是否仍出现自动退出问题。
- 打开浏览器开发者工具的Console面板,查看是否存在
TypeError: Cannot read properties of undefined (reading 'includes')的报错信息。 - 检查docker-compose.yml文件,确认fastgpt与mysql的端口配置无语法错误,且两个服务的端口映射、内部连接端口匹配。
- 重启FastGPT与mysql的容器,重新启动服务后验证页面状态。
- 若问题仍存在,需按实际环境确认系统API兼容性相关配置。
解决与验证
若为配置文件错误,修正docker-compose.yml中的端口配置,确保fastgpt连接mysql的端口与mysql容器暴露的端口一致,保存配置后重新启动容器。若为API兼容性问题,需按实际环境确认适配方案。验证方式:重新新建工作流并进入对应页面,确认不会自动退出,控制台无报错信息。