故障排查表

更新于 2026-10-21v3.0

本册的截图和说法以 2026-10-21 的界面为准；之后上线的变化见「新功能」。新功能

这张表按症状排，不按模块排——出问题的时候，人是从界面上那句话开始找的。「症状」一列尽量用控制台的原话，可以直接在这张表里搜。每一行的「处理」都是管理员自己做得完的动作；需要找部署负责人的，也写清楚了。

先分清三个词，它们不是一个意思

控制台在这三种情况下用不同的说法，误读它们会把排查方向带偏：暂无＝确认过，就是没有；暂无法确认＝这次没读到，状态未知，不代表没有；不可用＝确认处于坏状态。看到「暂无法确认」时先刷新或重新登录，不要据此断定资源不存在。

按提示文字排查，不要找错误码

多数页面会把后端状态码转成一句可执行的中文再显示，所以界面上通常没有数字错误码可抄。用这张表时以中文原话为准。

第 1 章登录与权限

症状（界面原话）	可能原因	去哪看	处理
暂时无法确认该组织的登录方式	组织标识拼写不对，或后端暂时不可达。不是口令问题。	登录与会话	先核对组织标识拼写；确认无误后联系部署负责人确认组织是否已开通。
当前组织并发登录额度已满，请稍后重试	同时在线人数达到许可证的并发上限。	登录与会话	等待他人退出，或联系部署负责人调整授权额度。
许可证宽限期已结束（全站红色横幅）	许可证已过期，受授权保护的登录与 Agent 操作会被拒绝。	授权与续期	联系部署负责人续期。详见授权与续期。
当前角色无权执行某个动作，本次没有发生写入	当前账号是只读角色，或缺少对应的角色绑定。	角色与权限	请平台管理员在角色与权限里补一条角色绑定。
成员或用户组标记为「未授权」	该成员没有任何角色绑定；或组织身份源里的用户组没有映射到本组织的角色。	身份同步	至少配一条低风险授权规则；用户组走身份同步的映射。

第 2 章资料接入与同步

症状（界面原话）	可能原因	去哪看	处理
本次没有完成连接测试，也不会保存配置或启动同步	连接地址或凭据失效，或服务账号缺少只读权限。	资料	依次检查地址、凭据有效期、只读权限。测试是只读的，失败不会留下半条配置。
本地授权无效、已过期或与路径不匹配	本地路径授权与所填路径不是同一个文件夹，或授权已过期。	资料	确认路径与授权来自同一个文件夹，或重新做一次本地授权。
请先运行同步前检查，检查通过后再创建知识源	没有跑预检，或改过路径/授权使预检失效。	资料	重新运行同步前检查，通过后再创建知识源。
有 N 个知识源失败，M 个同步任务失败	来源侧权限、格式或可读性问题导致入脑失败。	消化	进入资料来源看失败来源与未入脑文件明细，修好权限或格式后重新同步。
自动重试已停止，需管理员处理	同一条内容自动重试已达 5 次上限，进入待人工处理状态。	消化	打开未入脑明细看失败分类，修完权限/配置/内容后手动重试。
条目超过处理上限	单条内容超出连接器的单行或单页字节上限。	限制与配额	缩小同步范围或拆分内容；其余已入脑的知识不受影响。上限见限制与配额速查表。

第 3 章知识、治理与检索

症状	可能原因	去哪看	处理
资料上传成功，员工却搜不到	资料进入大脑后处于待确认状态，未发布的内容不进入员工检索。	知识	去工作台的「待办」确认并发布（也可以在我的空间 › 资料 › 全组织里按「待确认」筛出来）。这是整条链路上最常被误解的一步。
条目已发布，员工仍然搜不到	该条目是受限分级：进受限索引，不进普通检索。	知识	核对条目的敏感度分级；需要普通检索则调整分级后重新发布。
授权配好了，员工还是什么都搜不到	台账里那条授权标着「未命中」——匹配值在大脑里根本不存在。	大脑授权	核对授权用的标签或条目在大脑里确实存在，注意大小写与全角半角。
停用或删除授权之后，部分员工搜不到了	停用或删除只收回这条授权增加的读者，这些员工原本是靠这条授权看到的	大脑授权	要让他们继续看到，重新启用这条授权，或请资料的所有者在「共享」里加上他们。见大脑授权。
员工账号台账显示「可登录 · 未归属部门, 按部门授权取不到」	该账号没有被任何按部门的授权覆盖。	大脑授权	给他所在部门配授权，或按员工单独授权。
疑似凭证或密钥，会被阻止入库	预入库分类判定该内容含密钥，主动拦截。	附件与中断	确认是否误判；确需入库先脱敏再传。
租约已过期，等待恢复／已标记处理中（无运行记录）	治理任务的执行器中断，任务卡在处理中。	运行时与沙箱	在任务面板接管该任务，确认执行器状态后重试或转人工。

第 4 章模型调用与网关

症状（界面原话）	可能原因	去哪看	处理
连接失败：凭据被拒绝／对方返回未授权	通道的密钥环境变量名填错，或该变量没有在网关侧注入。	模型通道	核对通道填写的密钥变量名，确认部署侧已注入该变量。
连接失败：连接超时／对方在超时时间内没有响应	模型服务过载或网络不通。	模型通道	检查模型服务负载与网络；必要时由部署负责人调大超时。
连接失败：证书校验失败／对方的 HTTPS 证书不被信任	证书过期，或内网自签 CA 没有配给网关。	模型通道	确认证书有效期；内网 CA 需要在部署侧配置给网关。
连接失败：这条通道还没配置完整	通道处于停用状态，或地址、模型名等必填项没填完。	模型通道	补全必填项并启用通道，再点「测试连接」。
模型通道不可用／异常保护中	该后端连续失败 5 次，触发保护并进入 30 秒冷却。	模型通道	修好后端后等冷却结束自动放行探测；持续异常请部署负责人查网关日志。
通道状态显示「未巡检」	出网通道不在自动巡检范围内——这是设计，不是故障。	模型通道	需要确认时用「测试连接」按需探测。
模型网关就绪检查未通过或尚未获得可用结果	就绪探测没拿到可用结果。	监控大盘	去模型通道检查后端配置、网络与凭据引用，修好后重跑检查。

第 5 章配额、预算与账务

症状（界面原话）	可能原因	去哪看	处理
有主体已用满当期配额	某个员工或部门触达了每日或每月配额上限，新调用会被拒绝。	预算保护	上调该主体限额、等周期重置，或核查是不是异常用量。
本轮因调用额度或并发限制没有完成，已保留会话状态	配额门拦下了这次调用；会话没有丢。	附件与中断	稍后重试，或请管理员调整配额。
未配置预算保护，扩大使用前建议先确认调用保护策略	出厂默认没有 Token／请求／并发上限，月度预算为 0。	预算保护	规模化使用前先建预算行或由部署侧配置调用保护。见预算保护。
成本页给不出预算余量判断	没有设预算观察线，页面只能报当前用量。	成本与预算	设一条预算观察线，之后接近阈值会在成本页直接提示。

第 6 章审计、导出与数据主权

症状（界面原话）	可能原因	去哪看	处理
审计库可读，但还没有审计记录	新环境还没有产生过审计事件。	审计日志	先做一次登录、配置或导出，再回审计页确认记录出现。
当前筛选范围暂时不能直接导出	范围超过 7 天、没有选完整时间范围、预计条数超过上限，或当前是只读角色。	审计日志	缩小筛选范围直接导出，或提交受控导出申请等待批准。门槛见限制与配额速查表。
导出包没有通过校验，下载仍保持锁定	下载内容的哈希与记录的哈希不一致。	组织数据导出	重新生成导出包；仍然失败请联系部署负责人。锁定是保护，不是故障。
导出任务显示「已过期」	导出产物超过 24 小时有效期。	组织数据导出	重新发起导出，并在 24 小时内下载。
删除请求停在冷静期	删除进入冷静期，期间可以撤销。	删除一名员工	冷静期结束后逐字输入确认短语、点「执行删除」才会执行；不想删就在期内点「撤销该请求」。见删除一名员工。
导出范围显示「未知」	还没有关联导出，范围此时确实无法计算。	组织退订	先关联一个已就绪的导出，范围随即可见。

第 7 章运行环境、任务与容量

症状（界面原话）	可能原因	去哪看	处理
无法确认调度器状态	读不到调度器心跳，定时任务可能不会按时触发。	定时任务	刷新重试；持续如此请联系部署负责人。
任务已停用，请先启用再排入调度	该任务连续失败 3 次，被自动停用。	定时任务	先看执行历史里的失败原因，修好后手动重新启用。
当前环境未配置沙箱后端	部署没有配置沙箱运行后端。	运行时与沙箱	由部署负责人配置；未配置时相关能力只读。
沙箱池已没有可用容量	并发沙箱已经占满。	运行时与沙箱	等待释放，或请部署负责人调整容量。
数据或证据存储的可用容量低于安全线	剩余空间低于阻断阈值，大文件导入已被暂停。	部署检查	释放或扩容存储后重跑部署检查，再恢复导入与批量治理。
文件或目录暂时不可读，它可能已经被清理、重新生成，或所在运行环境已过期	沙箱运行环境已回收。	运行时与沙箱	刷新文件列表；必要时重跑任务。
本轮被组织安全策略拦截，没有继续调用模型或写入正式知识库	内容命中了数据防护规则。	数据防护	脱敏后重试，或在数据防护页确认规则是否过严。