OpenSearch Java客户端2.19.0异常类型及对应HTTP状态码查询
OpenSearchException(2.19.0 Java客户端)错误类型及对应HTTP状态码
以下是OpenSearch Java客户端抛出的OpenSearchException中type属性的常见取值,以及对应的HTTP状态码和场景说明:
- illegal_argument_exception:HTTP 400(Bad Request),请求参数不合法,比如查询语法错误、参数格式不符合要求。
- mapper_parsing_exception:HTTP 400(Bad Request),文档映射解析失败,比如字段类型不匹配、自定义映射定义存在语法错误。
- index_not_found_exception:HTTP 404(Not Found),目标索引不存在。
- document_not_found_exception:HTTP 404(Not Found),目标文档不存在。
- action_request_validation_exception:HTTP 400(Bad Request),请求动作验证未通过,比如批量写入请求中存在不符合规则的操作。
- version_conflict_engine_exception:HTTP 409(Conflict),文档版本冲突,常见于并发更新场景下版本号不匹配。
- resource_already_exists_exception:HTTP 409(Conflict),待创建的资源已存在,比如重复创建同名索引。
- circuit_breaking_exception:HTTP 429(Too Many Requests),触发集群熔断机制,通常是内存或CPU资源使用超过阈值。
- search_phase_execution_exception:HTTP 500(Internal Server Error),查询执行阶段失败,可能是集群分片异常、内部逻辑错误导致。
- cluster_block_exception:HTTP 503(Service Unavailable),集群处于阻塞状态,比如索引被设置为只读、集群节点不可用。
注:这些type值直接映射OpenSearch服务端返回的错误标识,更多小众类型可通过查看服务端错误响应体或客户端源码中的相关常量类获取。
内容的提问来源于stack exchange,提问作者yurii.pitomets
相关产品推荐
相关产品推荐

