这个错误是什么
该错误属于FastGPT应用模块的预定义枚举错误，枚举名为unExist，对应状态文本为appUnExist，错误码为502000，错误提示信息对应国际化文案键common:code_error.app_error.not_exist，用于标识目标应用不存在的业务异常场景。
什么情况下会触发
当系统或用户发起的操作关联的应用未在平台中注册、已被永久删除，或传入的应用标识参数无匹配记录时，会触发该错误。常见场景包括调用应用相关接口时传入了不存在的应用ID，或尝试访问已被删除的应用配置、调用记录等资源。
怎么定位
- 捕获接口返回的错误信息，识别
statusText字段值为appUnExist，同时核对错误码为502000； - 提取请求中携带的应用ID或应用标识参数，检查参数是否存在拼写错误、遗漏或使用了已失效的旧ID；
- 登录FastGPT应用管理界面，通过ID搜索或列表排查是否存在与请求中一致的有效应用；
- 确认目标应用是否因权限变更、系统清理等原因被移除，或未完成创建流程。
处理与验证
- 修正请求中的应用标识为系统中存在的有效ID，确保参数与平台内应用信息一致；
- 重新发起原业务请求，检查接口返回的状态与提示信息是否恢复正常；
- 若目标应用已被删除，可通过平台的备份功能恢复应用，或重新创建对应应用后重试；
- 完成操作后，验证相关业务流程如应用调用、配置修改等可正常执行，确认错误不再触发。
来源： FastGPT 官方来源
适用性与版本范围
本页适用于官方来源记录的 故障排查 场景。执行变更前，需核对 FastGPT、依赖、API 与部署版本。
安全护栏
凭证与私密数据使用 [REDACTED_CREDENTIAL] 占位符。执行操作前需核对文档的环境与版本。
回滚指引
恢复变更前的技术内容权威快照、已保存配置与数据快照，再执行最小验证场景。