Oracle Cloud Infrastructure Documentation


This section contains troubleshooting information for the Oracle Cloud Infrastructure Java SDK.

ObjectStorage client does not close connections when client is closed.

Too many file descriptors are opened up, and it takes too long to close existing ones. An exception may look like this:

Caused by: classes/caspertest.pem (Too many open files)
at Method)

Use one of the following workarounds to fix this issue.

  • Make this call before creating a client: System.setProperty("http.keepAlive", "false");
  • Use this command line argument when running Java: -Dhttp.keepAlive=false

Serialization errors when making requests or handling responses

If you encounter an UnrecognizedPropertyException error when handling a response to a call against the Java SDK, this indicates that the version of the Jackson library in use does not support a feature that was injected at runtime from another dependency in your application's class path. This happens even if the FAIL_ON_UNKNOWN_PROPERTIES deserialization property is set to false for the configured ObjectMapper.


Determine which version of Jackson libraries are referenced in your application’s class path and, if necessary, upgrade to version 2.9.5. For a complete list of Jackson libraries that the Java SDK depends on, please refer to the pom.xml file that is hosted on GitHub.


If you customize a client when instantiated in your application, ensure that you reference the preconfigured ObjectMapperfrom the RestClientFactory using the RestClientFactory#getObjectMapper() method.

An alternative solution is to to use the shaded version of the Java SDK jar file, which includes a bundled version of the Jackson libraries.

Encryption key size errors

By default, the Java SDK can only handle keys of 128 bit or lower key length. Users get "Invalid Key Exception" and "Illegal key size" errors when they use longer keys, such as AES256.

Use one of the following workarounds to fix this issue.

Troubleshooting Service Errors

Any operation resulting in a service error will cause an exception of type to be thrown by the SDK. For information about common service errors returned by OCI, see API Errors.