错误码说明

Soln 会用比较简洁的方式展示错误，方便你快速判断下一步该做什么，也方便把有效信息发给管理员或支持人员。

大多数页面加载失败时，会显示一个较大的状态码，例如 404 或 503，以及一句简短的状态说明，例如 未找到 或 服务不可用。

如果你查看一次失败请求的详细信息，可能还会看到三个结构化字段：

字段	含义
`code`	稳定的错误分类，用来说明大致是哪类失败
`reason`	具体失败原因，短小且可读，例如 `provider_timeout`
`domain`	失败发生的业务区域，例如 `assistant`、`form_data`、`iam`、`workspace_app`

你不需要记住这些字段。它们主要用于帮助管理员定位对应的系统区域。

页面上看到的状态码

如果页面无法加载，Soln 会显示该页面对应的 HTTP 状态码：

状态	含义	你可以怎么做
`400 错误的请求`	当前请求不合法	刷新页面；如果反复出现，检查当前链接或选中的数据是否仍然有效
`401 未授权`	你未登录，或登录状态已过期	重新登录
`403 禁止访问`	当前账号没有访问权限	联系管理员检查角色或权限配置
`404 未找到`	页面或数据已经不存在	回到列表后重新打开该数据
`408 请求超时`	请求耗时过长	稍后重试
`409 冲突`	当前操作与数据状态冲突	刷新页面，确认是否已有其他人修改了数据
`422 无法处理的实体`	系统理解了请求，但提交的数据无法处理	检查你填写或提交的数据
`429 请求过多`	短时间内请求过多	等待一会儿再重试
`499 客户端关闭请求`	浏览器或客户端在请求完成前关闭了连接	如果仍需要结果，可以重新操作
`500 服务器内部错误`	服务发生了非预期错误	可以先重试一次；如果反复出现，联系管理员
`502 错误的网关`	依赖服务返回了无效响应	稍后重试
`503 服务不可用`	某个服务不可用，或暂时过载	稍后重试，或联系管理员检查服务状态
`504 网关超时`	依赖服务没有及时响应	稍后重试

reason 可以帮助缩小问题范围：

Reason	通常表示
`provider_timeout`	AI 供应商请求或 Assistant 工具链路超时，或被中断
`provider_request_failed`	AI 供应商请求没有成功返回
`content_filtered`	请求或响应被供应商安全规则拦截
`model_not_found`	选择的 AI 模型不可用
`record_not_found`	表单记录不存在，或当前账号无法访问
`permission_denied`	当前用户或集成没有权限
`record_ids_required`	当前操作需要传入一个或多个记录 ID

同一个 reason 可能出现在不同业务区域。domain 用来说明它发生在哪个区域。

向管理员反馈错误时，建议提供：

如果是 Assistant 相关错误，也建议说明当时选择的模型，以及回答是否已经开始输出。

以下情况通常可以重试：

如果同一个错误连续出现，不建议马上反复重试。可以等待一会儿，或联系管理员检查服务状态、权限配置或供应商配置。