---
title: Elasticsearch Java Client known issues
description: For detailed issues, refer to the Java client repo. Version 9.3.0 of the client introduced a long list of breaking changes to better represent the server's...
url: https://www.elastic.co/elastic/docs-builder/docs/3016/release-notes/elasticsearch/clients/java/known-issues
products:
  - Elasticsearch Client
  - Elasticsearch Java Client
---

# Elasticsearch Java Client known issues
For detailed issues, refer to the [Java client repo](https://github.com/elastic/elasticsearch-java/issues).

## 9.3.0

Version 9.3.0 of the client introduced a long list of breaking changes to better represent the server's API, but some of the [changes](https://www.elastic.co/elastic/docs-builder/docs/3016/release-notes/elasticsearch/clients/java/9-3-0) from `String` to `List<String>` were wrong and have been fixed with the 9.3.1 release.
Here's the list of the reverted changes:
<dropdown title="List<String> to String">
  - elasticsearch._types.query_dsl.FieldLookup
    - `routing`: modified from `List<String>` to `String`, now optional
  - elasticsearch._types.query_dsl.MoreLikeThisQuery
    - `routing`: modified from `List<String>` to `String`, now optional
  - elasticsearch._types.query_dsl.PercolateQuery
    - `routing`: modified from `List<String>` to `String`, now optional
  - elasticsearch._types.query_dsl.TermsLookup
    - `routing`: modified from `List<String>` to `String`, now optional
  - elasticsearch.core.bulk.BulkOperationBase
    - `routing`: modified from `List<String>` to `String`, now optional
  - elasticsearch.core.reindex.Destination
    - `routing`: modified from `List<String>` to `String`, now optional
  - elasticsearch.core.search.CompletionSuggestOption
    - `routing`: modified from `List<String>` to `String`, now optional
  - elasticsearch.indices.Alias
    - `indexRouting`: modified from `List<String>` to `String`, now optional
  - `routing`: modified from `List<String>` to `String`, now optional
  - `searchRouting`: modified from `List<String>` to `String`, now optional
  - elasticsearch.indices.PutAliasRequest
    - `indexRouting`: modified from `List<String>` to `String`, now optional
  - `routing`: modified from `List<String>` to `String`, now optional
  - `searchRouting`: modified from `List<String>` to `String`, now optional
  - elasticsearch.indices.update_aliases.AddAction
    - `indexRouting`: modified from `List<String>` to `String`, now optional
  - `routing`: modified from `List<String>` to `String`, now optional
  - `searchRouting`: modified from `List<String>` to `String`, now optional
</dropdown>


## 9.x

All 9.x versions of the client previous to, respectively, 9.2.4, 9.1.10 and 9.0.9 are affected by a bug with the new Rest5Client where memory usage is substantially higher than necessary.
This problem was [fixed](https://github.com/elastic/elasticsearch-java/pull/1122) in 9.2.4, 9.1.10 and 9.0.9.

## 9.0.0

The 9.0.0 version of the client uses the new built-in `Rest5Client`, instead of depending on `elasticsearch-rest-client`. But the 9.0.0 client still depends on Apache `commons-logging`, which causes the following exception when not available:
```
Exception in thread "main" java.lang.NoClassDefFoundError: org/apache/commons/logging/LogFactory
	at co.elastic.clients.transport.rest5_client.low_level.Rest5Client.<clinit>(Rest5Client.java:115)
	at co.elastic.clients.transport.rest5_client.Rest5ClientTransport.buildRest5Client(Rest5ClientTransport.java:65)
	at co.elastic.clients.transport.rest5_client.Rest5ClientTransport.<init>(Rest5ClientTransport.java:42)
	at co.elastic.clients.transport.ElasticsearchTransportConfig$Default.buildTransport(ElasticsearchTransportConfig.java:110)
	at co.elastic.clients.elasticsearch.ElasticsearchClient.of(ElasticsearchClient.java:190)
```

This problem was [fixed](https://github.com/elastic/elasticsearch-java/pull/1010) in 9.0.1.
To fix this issue in 9.0.0 and use the new `Rest5Client`, add the `commons-logging` dependency:
```kotlin
// gradle
implementation("commons-logging:commons-logging:1.3.5")
```

```xml
<!--maven-->
<dependency>
    <groupId>commons-logging</groupId>
    <artifactId>commons-logging</artifactId>
    <version>1.3.5</version>
</dependency>
```


## 8.16.7

8.16.7 is the first patch released without a matching rest-client version. The `elasticsearch-rest-client` dependency is missing, causing the following exception:
```
Could not resolve dependencies for project
[ERROR] dependency: org.elasticsearch.client:elasticsearch-rest-client:jar:8.16.7 (compile)
[ERROR] 	Could not find artifact org.elasticsearch.client:elasticsearch-rest-client:jar:8.16.7 in central (https://repo.maven.apache.org/maven2)
```

To use this version of the client, set the latest available version explicitly in the project:
```kotlin
// gradle
implementation("org.elasticsearch.client:elasticsearch-rest-client:8.16.6")
```

```xml
<!--maven-->
<dependency>
    <groupId>org.elasticsearch.client</groupId>
    <artifactId>elasticsearch-rest-client</artifactId>
    <version>8.16.6</version>
</dependency>
```