配置类异常
范围:BusinessException / 个别 RuntimeException 的 message 是因为后台菜单、YAML、环境变量没配好。用户去对应配置处改完再重试。
不写:不能为空、不存在、无权限、单据状态不允许、以及「先删应用再删领域」这类操作顺序。
运行时仍然没有 errorKey,前端看到的是 RespInfo.message。
| 去哪改 | 典型原文 | 规范页 |
|---|---|---|
| 代码生成 → 数据源配置,或应用「高级数据设置」 | 当前数据存储未允许自动建表,请在高级数据设置中开启自动建表 | 运行数据源与自动建表 |
forge.flow.client.url、应用主流程 | 流程服务未配置,无法发起主流程 | 流程服务与主流程 |
| AI → 供应商管理 / 智能体 / 知识库 | 未配置可用的默认 AI 供应商 | AI 供应商与知识库 |
| 数据资产连接、持久化密钥 | 数据连接密码解密失败,请检查持久化密钥配置 | 数据连接与密钥 |
| YAML / 环境变量开关 | API配置功能未开启、Pepper 未配置、dynamic-datasource 未启用 | 运行开关与密钥注入 |
| 企业协同、外部接口、社交登录 | 企业协同连接未配置企业ID | 集成连接 |
| 定时任务与调度服务 | 任务尚未同步到调度服务,请先重新同步 | 定时任务调度 |
完整抛出点清单只给维护者看:.docs/catalog/business-exceptions.yml(约 1800 条,不要当用户手册)。
