请求出现错误后,将会有错误码及错误信息返回,您可以在这里进一步确定错误原因,及时修改,确保访问正确进行。
常见错误处理
| 错误码 | 处理方式 | 
| 1000 | 一般为超时引起,重试后查看是否还会出现。如仍有报错,请提交工单,值班人员会尽快排查处理。 | 
| 2112 | 业务排序中使用的字段没有完全包含再索引字段里面,则会出现报错,但不影响搜索结果。 | 
| 3007 | 对于API推送系统是有频率限制,请控制好频率重试。 | 
| 4003 | 可以先按照文档样例,试下签名结果是否一致,判断是否是签名算法问题。如果不是,请检查下参数按照字典序排序后应该是公共参数(大写字母)在前,请求参数(小写字母)在后。另外还有空格等一些编码规则,具体参考授权文档介绍。 | 
| 4007 | 一般JSON字段内容中包含双引号或者不可见字符会导致格式解析失败,请转义或者过滤后重试。 | 
| 4010 | TimeStamp参数是有过期时间的,请按照要求格式取当前时间来计算。 | 
| 5001 | 没有找到对应的用户,一般为ACCESSKEY信息不正确,或者使用区域域名错误(API域名请以应用管理-》基本信息-》API入口为准),请检查修改后重试。 | 
| 5008 | 服务内部是通过AccessKey来进行用户身份校验的,请确保AccessKey已经开启,您可以通过控制台AccessKey管理入口来创建和删除。 | 
| 6013 | start+hit不能超过5000,否则会报错无结果。需要超过5000的请求,请查看下API文档中的SCROLL接口,看是否满足需求。 | 
| 6015 | 计算资源(LCU)超过购买的配额请求被丢弃,请登录控制台,在应用列表页点击“扩缩容/变规格”,进行扩容。 | 
| 6127 | 除了query子句,其他子句出现的字段都必须配置为属性字段才能使用。请修改应用结构后重试(可以通过线下变更配置属性字段)。 | 
| 7500 | 系统内部错误。若报此错误,请提交工单,我们会尽快排查处理。 | 
系统级别(1000-1999)
| 错误码 | 错误说明 | 
| 1000 | 系统内部错误 | 
| 1001 | 没有找到模板 | 
| 1003 | 不支持的索引类型 | 
| 1004 | 服务暂时不可用,请稍后再试 | 
应用相关(2000-2999)
| 错误码 | 错误说明 | 
| 2001 | 待查应用不存在 | 
| 2002 | 应用已经存在 | 
| 2003 | 到达创建应用总限制 | 
| 2004 | 应用名不可用。应用名由数字、26个英文字母或下划线组成,长度不超过30位 | 
| 2005 | 应用名称没有设定 | 
| 2006 | 新应用名称没有设定 | 
| 2007 | 备注不超300字 | 
| 2008 | 摘要配置参数错误 | 
| 2009 | 更新状态失败 | 
| 2010 | 应用暂停中 | 
| 2011 | 应用冻结中 | 
| 2012 | 应用未开启 | 
| 2013 | 删除失败,没有此应用 | 
| 2014 | 文件上传失败 | 
| 2016 | 区域信息没有 | 
| 2017 | 此应用并不属于当前区域 | 
| 2099 | 当前接口暂时不提供服务。 | 
| 2101 | 表达式不存在 | 
| 2102 | 表达式名称被占用 | 
| 2103 | 到达该应用表达式总数限制 | 
| 2104 | 表达式名不可用。表达式名由数字、26个英文字母或下划线组成,长度不超过30位 | 
| 2105 | 表达式名称没有设定 | 
| 2106 | 新表达式名称没有设定 | 
| 2107 | 表达式备注不超过300字 | 
| 2108 | 表达式备注格式错误 | 
| 2109 | 表达式格式错误 | 
| 2110 | 表达式长度超过限制 | 
| 2111 | 表达式ID未指定 | 
| 2112 | 表达式错误 | 
| 2113 | 表达式不能为空 | 
| 2114 | 操作错误 | 
| 2201 | 粗排配置名没有设定 | 
| 2202 | 粗排配置名已经存在 | 
| 2203 | 粗排配置个数超出限制 | 
| 2204 | 粗排配置名错误。只能由数字、26个英文字母或下划线组成 | 
| 2205 | 粗排配置名长度超出限制 | 
| 2206 | 粗排字段必须是数值型 | 
| 2207 | 粗排配置不存在 | 
| 2208 | 粗排配置错误,必须包含字段 | 
| 2209 | 粗排配置权重错误,必须是-100000到100000之间的非0数值,浮点数精度支持6位 | 
| 2210 | 与系统默认粗排配置重名 | 
| 2211 | timeliness()的参数必须是INT类型 | 
| 2112 | 排序表达式错误 | 
| 2551 | 查询指定的下拉提示规则不存在 | 
文档相关(3000-3999)
| 错误码 | 错误说明 | 
| 3001 | 文档不能为空 | 
| 3002 | 文档大小超过限制 | 
| 3003 | 已经到最大文档数 | 
| 3004 | 保存文档失败 | 
| 3005 | doc格式错误 | 
| 3006 | 文档操作cmd不合法 | 
| 3007 | 请求过于频繁 | 
| 3008 | 文档总长度太长 | 
| 3009 | 没有文档ID | 
| 3011 | 在配置RDS或MYSQL数据源后,不支持API推送文档 | 
| 3012 | 未找到指定资源 | 
| 3013 | 文档推送速率超过应用配额 | 
| 3014 | 文档推送速率触发系统限制 | 
| 3015 | 单次推送文档个数超过系统限制 | 
| 3016 | 文档总数超过应用配额 | 
授权相关(4000-4999)
| 错误码 | 错误说明 | 
| 4001 | 认证失败 | 
| 4002 | 需要设置签名 | 
| 4003 | 签名验证失败 | 
| 4004 | 需要设置SignatureNonce | 
| 4005 | SignatureNonce不能重复使用 | 
| 4006 | SignatureNonce验证失败 | 
| 4007 | 解析JSON格式失败 | 
| 4008 | 用户名称不能为空,请检查域名正确性 | 
| 4009 | 需要指定用户标识 | 
| 4010 | 时间过期 | 
| 4011 | demo账号禁止执行的操作 | 
| 4012 | 数据表不存在 | 
| 4013 | Timestamp格式错误 | 
| 4014 | 需要设置Timestamp | 
| 4020 | RAM子账户鉴权失败 | 
用户相关(5000-5999)
| 错误码 | 错误说明 | 
| 5001 | 用户不存在 | 
| 5002 | 用户名不正确 | 
| 5003 | 需要用户登录 | 
| 5008 | 用户没有启用ACCESSKEY | 
| 5100 | 用户没有此区域的操作权限 | 
| 5004 | 用户未缴费 | 
| 5005 | 用户未开通OpenSearch服务,请前往阿里云官网开通 | 
| 5006 | 欠费冻结中 | 
| 5008 | 用户没有启用ACCESSKEY | 
| 5009 | 用户已经删除 | 
| 5010 | ACCESSKEY 已经禁用 | 
| 5011 | 通过邮箱获取到多个用户 | 
| 5012 | CODE_USER_ALIYUN_USER_ID_INVALID,错误信息为空 | 
| 5013 | CODE_USER_ALIYUN_BID_INVALID,错误信息为空 | 
| 5014 | CODE_USER_CLIENT_ID_INVALID,错误信息为空 | 
| 5015 | CODE_USER_ID_INVALID,错误信息为空 | 
| 5100 | 用户没有此区域的操作权限 | 
搜索相关(6000-6999)
| 错误码 | 错误说明 | 
| 6001 | 查询query为空 | 
| 6002 | 并不被支持的搜索key关键字 | 
| 6003 | 并不被支持的搜索field关键字 | 
| 6004 | 复杂查询为空 | 
| 6005 | field无效 | 
| 6006 | 请求包含太多应用名 | 
| 6007 | 超出多索引查询每个模板中索引总数 | 
| 6008 | 请求串语法错误,解析失败 | 
| 6009 | 查询子句过长 
 | 
| 6010 | 无效的rerank size | 
| 6011 | SignatureNonce格式错误 | 
| 6013 | start+hit超过系统限制 | 
| 6014 | 因系统繁忙,请求被丢弃 | 
| 6015 | 因搜索计算资源(LCU)超出配额,请求被丢弃 | 
| 6016 | 查询hit数超过系统限制 | 
| 6017 | 目前scroll只支持search_type为scan,也就是说设置了参数scroll,就必须设置参数search_type=scan | 
| 6018 | 设置了scroll参数,但没有search_type参数 | 
| 6019 | 传入的scroll_id参数解析失败 | 
| 6020 | 无效的scroll参数值 | 
| 6021 | scroll请求不支持Aggregate/Sort/Distinct,当传入这些clause时,会报错 | 
| 6022 | scroll_id已经过期失效了 | 
| 6024 | 下拉提示的hit参数值不合法 | 
| 6031 | abtest参数值不合法 | 
| 6033 | re_search参数值不合法 | 
| 6034 | biz参数值不合法 | 
| 6100 | 查询词为空 | 
| 6101 | 查询的索引字段不存在 | 
| 6102 | Query中的数值范围错误 | 
| 6103 | Filter中的表达式返回值必须为bool类型 | 
| 6104 | Sort中的表达式返回值不能为bool类型 | 
| 6105 | Sort中存在相同的表达式 | 
| 6106 | 查询query语句非法 | 
| 6107 | 统计函数表达式的返回值不能为bool或者string类型 | 
| 6108 | 统计中的范围必须为升序 | 
| 6109 | 统计中的范围表达式返回值类型错误 | 
| 6110 | 统计函数不存在 | 
| 6111 | 不支持的统计函数 | 
| 6112 | Query 子句错误 | 
| 6113 | Filter子句错误 | 
| 6114 | Aggregate子句错误 | 
| 6115 | Sort子句错误 | 
| 6116 | Distinct子句错误 | 
| 6117 | 查询中包含未知的子句 | 
| 6118 | 语法错误 | 
| 6119 | Distinct子句中的dist_count值错误,应该为大于0的整数 | 
| 6120 | Distinct子句中的dist_times值错误,应该为大于0的整数 | 
| 6121 | Distinct子句中的reserved值错误,应为true/false | 
| 6122 | Distinct子句缺少distinct_key | 
| 6123 | Distinct子句中的grade值错误,例如为空,或非数值 | 
| 6124 | Distinct子句中包含distinct个数不对,个数应在(0,2] | 
| 6125 | Distinct子句中的max_item_count值错误,应该为大于0的整数 | 
| 6126 | Distinct子句中的update_total_hit值错误,应为true/false | 
| 6127 | 请求中包含了未定义的attribute字段,请修改应用结构后重试(可以通过线下变更配置属性字段) | 
| 6128 | 表达式中的二元操作符的两边的表达式结果类型不匹配 | 
| 6129 | 表达式中的二元操作符的两边表达式不能同时为常量 | 
| 6130 | 二元逻辑运算表达式类型错误,应为bool类型 | 
| 6131 | 二元表达式中不支持string类型 | 
| 6132 | 二元表达式中不支持数组类型 | 
| 6133 | 位操作中的类型错误 | 
| 6134 | 常量表达式的返回值类型错误 | 
| 6135 | 常量表达式类型错误,LITERAL类型的字段值在filter子句中必须要使用双引号,否则就会报该错误。 | 
| 6140 | Aggregate clause syntax error, 字段类型是LITERAL无法支持SUM | 
| 6300 | 常量表达式类型应是整数或浮点数 | 
| 6301 | 位取反操作数类型必须为整数 | 
| 6302 | 取负数操作数必须为数值 | 
| 6303 | 逻辑非操作数必须为数值 | 
| 6304 | 二元运算操作数类型错误 | 
| 6305 | 非法的二元运算符 | 
| 6306 | 函数参数类型错误 | 
| 6307 | 函数未定义 | 
| 6308 | 函数参数个数错误 | 
| 6309 | 非法的数组操作 | 
| 6310 | 可过滤字段不存在 | 
| 6311 | 数组字段被错当作单值使用 | 
| 6312 | 单值字段被错当作数组使用 | 
| 6313 | 数组字段下标越界(小于0) | 
| 6314 | 不支持的字段类型 | 
| 6315 | 索引字段参数不存在 | 
| 6316 | Query中没有指定索引 | 
| 6317 | Filter子句中只能使用一次公式 | 
| 6318 | 公式语法解析出错 | 
| 6400 | 排序脚本不存在 | 
| 6450 | 执行脚本时出现异常 | 
| 6500 | 搜索语法中包含不存在的字段 | 
| 6501 | 在线系统没有索引数据 | 
| 6502 | 用户query语法错误 | 
| 6503 | 不支持默认操作符OR | 
| 6504 | 不支持精确统计 | 
| 6505 | 无效的rank size | 
| 6506 | 查询分词后term过多 | 
| 6601 | 一个索引字段只能包含在一个规则中 | 
| 6602 | 没有查询词,如default:’’的情况 | 
| 6603 | 查询中的索引字段没有在查询分析规则中指定 | 
| 6604 | 关键词没有使用引号括起来,如default:xxx,正确为default:’xxx’ | 
| 6605 | 双引号查询不能配置查询分析规则 | 
| 6606 | 提示型报错:查询query没有需要查询分析处理的索引 | 
| 6607 | disable参数格式错误 | 
| 6608 | disable指定关闭的索引字段不存在 | 
| 6609 | disable指定关闭的功能列表不存在 | 
| 6610 | 查询分析后的query为空(原query为空,或者全部是stopword) | 
| 6611 | 查询中没有指定索引字段 | 
| 6612 | term_weight makeup data fail.干预数据没有生效 | 
| 6613 | query子句中的term个数超过256个上限 | 
数据处理相关(7000-7999)
| 错误码 | 错误说明 | 
| 7202 | cmd不支持。不支持的commond,如update/add/delete以外的cmd | 
| 7301 | 文档主键字段不存在。文档主键不存在,推送失败 | 
| 7302 | 目标类型不匹配。文档主键非法,推送失败 | 
| 7303 | 文档主键是多值。文档主键值不支持多值类型,推送失败 | 
| 7304 | 文档主键字段为空。文档主键值为空,推送失败 | 
| 7305 | 推送了不属于这个应用的表。文档表名不存在,推送失败 | 
| 7500 | 系统内部错误。若报此错误,请提交工单,我们会尽快排查处理。 | 
| 7520 | 单个文档大小超过1m. 单个文档过长,超出系统限制,推送失败 | 
| 7503 | json 插件对应的字段内容不是json. json插件字段内容不是JSON格式,推送失败,请检查后重试 | 
| 7504 | json插件字段内容对应的key不存在,推送失败 | 
| 7505 | TairLDB插件出错,TairLDBExtractor内容转换配置错误:Tair连接失败,请检查configId或namespace是否有效 | 
| 7510 | keyvalue插件(KeyValueExtractor)处理字段出错,推送失败 | 
| 7515 | 过滤条件执行错误 | 
| 7523 | StringConnector插件处理出错,推送失败 | 
| 7524 | geo字段内容超范围,range字段内容超出经纬度范围(lon>180 ;lat>90) | 
| 7525 | geo字段格式非法,range字段内容格式不正确 | 
| 7601 | 任务执行出错。若报此错误,请提交工单,我们会尽快排查处理。 | 
| 7602 | odps table 数据为0, 确认odps分区正常产出再重试 | 
| 7607 | odps 无权限 | 
| 7603 | Mysql数据源(RDS/POLARDB)配置错误 | 
| 7605 | tddl配置错误 | 
| 7608 | Mysql数据源原字段缺失 | 
| 7803 | 更新一个不存在的文档,推送失败 | 
| 7805 | HTML插件处理出错,推送失败 | 
| 7807 | 字段类型和内容不匹配,转换到目标类型出错,字段将补充默认值 | 
| 73106 | 推送超配额,需要扩容 | 
| 7620 | 数据源查询执行超时 | 
文档错误内部通知(8000-8999)
| 错误码 | 错误说明 | 
| 8001 | 保存错误信息失败 | 
| 8002 | 必要参数缺失 | 
| 8003 | 应用不存在 | 
| 8004 | 参数错误 | 
模板相关(9000-9999)
| 错误码 | 错误说明 | 
| 9001 | 用户名为空 | 
| 9002 | 应用名为空 | 
| 9003 | 模板名不可用。模板名只能由数字、26个英文字母或下划线组成 | 
| 9004 | 模板名长度不可超过30位 | 
| 9005 | 查询模板信息出错 | 
| 9006 | 模板名字已存在 | 
| 9007 | 插入模板信息出错 | 
| 9008 | 无效的数据 | 
| 9009 | 定义的字段数目超过系统允许的最大字段数 | 
| 9010 | 此字段保留字段名 | 
| 9011 | 字段已存在 | 
| 9012 | 索引名称必须以字母开头,由数字、26个英文字母或下划线组成,长度不超过30位,多值字段类型不能为SWS_TEXT或TEXT | 
| 9013 | 不支持数组 | 
| 9014 | 不支持主键 | 
| 9015 | 未设定主键 | 
| 9016 | 主键不唯一 | 
| 9017 | 更新信息失败 | 
| 9018 | 删除信息失败 | 
| 9019 | 包含多个索引字段的搜索字段最多4个 | 
| 9020 | 同一个STRING/TEXT类型的索引字段不能进入多个只包含一个字段的搜索字段中 | 
| 9021 | 索引名称必须以字母开头,由数字、26个英文字母或下划线组成,长度不超过30个 | 
| 9022 | 该表已经关联 | 
| 9023 | 索引名不能包含多类型的字段 | 
| 9100 | 系统内部错误 | 
| 9101 | 该字段超过数量限制 | 
| 9102 | 该数据源未被用到 | 
| 9103 | 无效的外表连接 | 
| 9104 | 最多2级关联 | 
| 9105 | 待查模板不存在 | 
| 9501 | 用户名为空 | 
| 9502 | 应用名为空 | 
| 9519 | 未指定模板 | 
| 9600 | 系统内部错误 | 
| 9902 | 插件字段类型错误 | 
| 9999 | 此域名不提供本服务 | 
数据同步相关(10000-)
| 错误码 | 错误说明 | 
| 10001 | 没有指定的tddl group key,tddl信息获取失败 | 
| 10002 | 获取字段失败或者表不存在 | 
| 10011 | 连接agg失败 | 
| 10012 | 应用里存在doc | 
| 10013 | 应用不是自定义结构 | 
| 10110 | 该任务已结束 | 
| 10010 | 部分数据源有问题,已经忽略有错误的数据 | 
| 10014 | 数据源类型错误 | 
| 10100 | 创建任务失败,未结束的任务已经存在 | 
| 10101 | 没有指定应用ID | 
| 10106 | 没有指定应用ID | 
| 10107 | 没有指定应用ID | 
| 10102 | ACTION无效 | 
| 10112 | 文档数量超过限制 | 
| 10201 | 获取配额列表失败 | 
| 10202 | 更新配额失败 | 
| 10301 | 参数错误:参数未提供或者格式不正确 | 
| 10302 | 时间参数错误 | 
| 10303 | 数据源未配置 | 
| 10304 | 该表配额超限 | 
| 10305 | OSS参数错误 | 
| 10306 | OSS BUCKET名称无效 | 
| 10307 | OSS 记录类型无效 | 
| 10308 | OSS BUCKET日志功能未开启 | 
| 10309 | 存在未完成的任务 | 
| 10310 | 不是运行中的应用,无法创建任务 | 
| 10311 | 时间范围不合法 | 
| 10312 | 应用描述长度超过限制,最多600字 | 
| 10313 | OSS 内容格式不合法 | 
| 10314 | OSS BUCKET所在区域ACL网络不通 | 
| 10315 | OSS BUCKET的地址信息不合法 | 
| 10330 | 数据源参数不合法 | 
| 10350 | 连接ODPS服务失败 | 
| 10351 | ODPS 返回错误 | 
| 10400 | OSS前缀不合法 | 
| 10450 | 字段不存在 | 
| 4007 | JSON解码失败 |