You need to enable JavaScript to run this app.
导航
错误码与故障排查指南
最近更新时间:2025.02.14 18:16:16首次发布时间:2025.02.14 18:16:16

获取错误码

API

请求成功

当请求成功时,返回 code = 0,示例如下:

{"code":0,"message":"success","request_id":"02173901722303500000000000000000000ffff0a004c5f712d93"}

请求失败

当请求失败时,将返回相应的错误码。例如,code = 1000005 表示 collection 不存在,示例如下:

{"code":1000005,"message":"collection does not exist","request_id":"02173901687058500000000000000000000ffff0a004c5f532dbf"}

SDK

在 SDK 中,请求失败时会抛出异常。异常的返回内容与 API 返回格式相同,可进行异常捕获处理,并根据 code 值进行具体问题排查。

错误码排查

错误码

含义

触发条件

处理建议

0

请求成功

1000001

用户鉴权失败

例如 **** AK/SK 设置不正确、未对请求体签名或子账户权限不足

  • 检查 AK/SK 输入是否正确
  • 子账户权限不足,参考文档申请权限

https://www.volcengine.com/docs/84313/1254467

  • 使用官方文档中的api 签名demo 示例

https://www.volcengine.com/docs/84313/1254529

  • SDK 自动签名

https://www.volcengine.com/docs/84313/1254488

  • 检查是否对请求体做签名,并且签名内容加入请求头
  • 检查请求签名后,是否又修改请求体

1000003

请求参数不合法

输入请求参数格式不正确或错误使用

  • 根据报错信息检查请求参数,如报错内容不清晰请及时反馈

1000004

创建 collection 已存在

重复创建同名 collection

检查 collection 是否存在

1000005

请求的 collection 不存在

collection 名字写错或不存在

检查 collection 是否存在

1000007

创建的index已存在

同一个collection下创建 index 名称重复

检查index 是否存在

1000008

请求的index 不存在

index 名字写错或不存在

检查index 是否存在

1000011

collection 数据不存在

update_data 一条不存在的数据

检查数据是否存在

1000013

collection 删除数据失败

删除数据失败,一般是服务端出现问题

及时联系客服反馈

1000014

collection 写入数据失败

写入数据失败,一般是服务端出现问题

及时联系客服反馈

1000016

检索输入的向量不合法

向量输入不正确,维度不一致或格式不正确

检查检索请求的向量字段

1000017

输入的主键不合法

主键类型不匹配或格式不正确

检查主键字段

1000019

检索输入的标量过滤语句有问题

输入的格式不正确,字段未加入到scalar index中,字段过滤语句使用不当

1000021

Index 检索出现问题

服务端出现未知错误或发生故障

及时联系客服反馈

1000022

Index 获取数据出现问题

服务端出现未知错误或发生故障

及时联系客服反馈

1000023

Index 初始化中

Index 初始化时就对 index 进行检索或查询数据

等待 Index 已就绪,若长时间(超过1小时)依旧没有就绪,请及时联系客服反馈

1000025

执行Embedding 发生异常

服务端对非结构化数据做向量化时报错,出现未知错误或发生故障

若偶现报错请检查输入数据的格式是否合法
否则请及时联系客服反馈

1000028

服务端内部错误

服务端出现不符合预期的报错

及时联系客服反馈

1000029

请求触发限流

某个接口请求 qps 太高

若检索请求出现限流,请增加 CPU Quota,若有疑问可联系客服
若其他接口出现限流,请检查调用方式是否存在问题,例如重复的初始化 index/collection等,可以调整接口调用频率

1000031

Collection 别名不存在

Collection 别名写错或不存在

检查 Collection 别名

1000032

用户未下单

用户没有在对应区域(如华北)下单就请求该区域的向量库服务

到火山官网下单购买向量库服务,或到向量库界面下单
https://console.volcengine.com/vikingdb/region:vikingdb+cn-beijing/home

1000033

用户欠费逾期

用户欠费逾期

请充值

1000035

离线任务不存在

没有找到 task_id 对应的离线任务

检查离线任务是否存在