现象
私有化部署FastGPT时，创建知识库触发报错，报错完整文本为relation "modeldata" does not exist，对应报错截图可参考issue来源内容。
可能原因
该报错提示数据库中不存在名为modeldata的关联表，可能由数据库初始化流程未完整执行，或对应表被误删除导致，具体需按实际部署环境确认。
排查步骤
- 核对FastGPT部署流程中的数据库初始化环节，确认所有建表相关脚本是否完整执行。
- 通过数据库客户端连接目标数据库，执行查询语句确认是否存在名为modeldata的表。
- 检查FastGPT服务的数据库连接配置，确认服务可正常访问目标数据库。
解决与验证
若数据库中缺少modeldata表，执行对应建表脚本补全该表；若数据库初始化流程未完整执行，重新执行完整的部署初始化流程。完成操作后，重新尝试创建知识库，确认不再触发该报错。
来源： FastGPT 官方来源
适用性与版本范围
本页适用于官方来源记录的 故障排查 场景。执行变更前，需核对 FastGPT、依赖、API 与部署版本。
安全护栏
凭证与私密数据使用 [REDACTED_CREDENTIAL] 占位符。执行操作前需核对文档的环境与版本。
回滚指引
恢复变更前的技术内容权威快照、已保存配置与数据快照，再执行最小验证场景。