常见问题与故障排查(P0 高频场景)¶
本页汇总使用 MOI 控制台、AI Studio、Genesis 与 MatrixOne 云实例过程中最常见的高频异常与排查路径。若需检索特定 HTTP 或 JSON 返回码,请查看错误码与异常状态参考。
1. 登录、账号邀请与工作区权限¶
现象 |
常见原因 |
排查与处理 |
|---|---|---|
登录后界面缺少新建工作流、创建知识库或成员管理按钮 |
当前账号在该工作区绑定的角色未授予对应功能或对象权限 |
请工作区管理员在用户权限 → 角色权限中核对角色勾选范围,说明见角色权限 |
账号邀请被拦截或提示达到上限 |
账号注册级的“账号邀请”与“工作区成员邀请”独立计算;普通注册用户账号邀请默认上限为 10 |
|
生成个人访问令牌或调用接口时提示需要实名认证 |
当前部署开启了实名认证准入要求 |
使用账号当前已验证手机号与真实姓名完成核验后重试,步骤见完成实名认证 |
访问不同工作区对象时返回 |
顶栏切换到了错误工作区,或 API 请求头 |
在顶栏工作区切换器中复制正确的工作区 ID 后重新提交 |
2. API 调用与认证凭据异常¶
现象 |
常见原因 |
处理步骤 |
|---|---|---|
调用 AI Studio 接口返回 |
请求同时附带了多种凭据,最常见的是工具(Postman / Python |
保持单一认证方式:AI Studio 仅使用 |
调用 AI Studio 传入 |
混用了 Genesis 与 AI Studio 的认证请求头规范 |
Genesis 使用 |
调用 Genesis 接口返回 |
当前账户 Credit 余额不足以继续扣费 |
前往充值 Credit完成一次性充值,确认总览余额更新后重试 |
调用模型或已发布动态服务返回 |
触发 Token Key / 服务账号 RPM、TPM、并发上限,或上游模型渠道限流 |
检查响应头 |
3. 数据连接、载入任务与知识库排查¶
REST API 或对象存储连接器验证失败:检查连接器认证类型、密钥是否过期、接口完整地址及是否启用可公开访问路径;分页与预览行为见连接 REST API。
数据载入任务长时间运行中或失败:前往载入任务展开任务详情查看阶段错误原因,核对源编码格式、目标 Catalog 表结构映射及目标计算实例是否处于就绪状态。
知识库问答无结果、缺来源或 NL2SQL 未命中表:确认文档解析与索引任务已处于完成状态(创建知识库与配置来源);若在 SQL 编辑器手动建表但无法被知识库检索,请检查表是否按规范纳入 Catalog 管理(SQL 编辑器)。
4. 计算实例、托管沙箱与费用异常¶
现象 |
常见原因 |
处理建议 |
|---|---|---|
计算实例无法启动或启用失败 |
账户 Credit 余额不足(启用前额度检查拦截),或配额/底层资源暂时不可用 |
在查看费用与用量确认余额充足;若依赖自定义 Python 包,检查计算实例 · 配置自定义 Python 依赖的 |
托管运行环境一直处于“等待中”或创建报 |
当前工作区的托管沙箱数量达到上限,或所选计算资源负载排队 |
清理不再使用的闲置托管环境;如确实需要更多并发环境,联系平台管理员调整工作区配额 |
托管环境网络请求被拦截 |
只勾选了工具或只填写了白名单域名之一,或未写明端口号 |
打开环境配置同时放行允许联网工具与按 |
未发起对话仍有计算费用产生 |
创建了托管运行环境但未删除 |
托管环境自变为就绪起即使闲置也会连续按分钟计费;临时对话沙箱不单独收费。不再使用的托管环境应及时删除,详见计算资源与沙箱计费规则 |
5. IM 通道与智能体异常¶
若飞书、企业微信、Slack 或 Telegram 机器人无法接收消息、回调校验失败或无回复,请直接按 IM 接入常见问题与排查 核对签名凭证、事件订阅地址与模型发布状态。
6. MatrixOne 云实例连接、只读与计费边界¶
实例无法连接:检查实例是否处于运行中、连接端点端口及**网络策略(IP 白名单)**是否允许当前客户端出口 IP,或调整 TLS 连接参数(见数据库实例)。
用户权限报错:使用
用户名:角色名形式登录核对角色上下文,避免直接在日常 SQL 中依赖默认高权限账号,详见MatrixOne 权限。实例账单找不到:MatrixOne 实例的 CU、存储和续费账单与平台 Credit 账本分开核算,详见实例计费。
提交工单前需要准备的信息¶
如果以上自检未能定位问题,请打开技术支持与反馈,并通过控制台反馈助手或支持邮箱附上以下信息(切勿包含密码、AK/SK 或访问令牌明文):
工作区 ID、受影响资源名称及完整发生时间;
对应的载入任务 ID、工作流运行 ID、会话 ID、SQL
Query ID或 GenesisRequest ID(充值异常请附订单号);完整 HTTP 状态码、
code与报错原文(可附脱敏截图)。