Exception thrown due to internal errors. Means some invariants expected by underlying system has
been broken. If you see one of these errors, something is very broken.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[[["\u003cp\u003eThis page details the \u003ccode\u003eInternalException\u003c/code\u003e class in the Google API Client Library for Java (gax), a subclass of \u003ccode\u003eApiException\u003c/code\u003e that signals broken system invariants.\u003c/p\u003e\n"],["\u003cp\u003eThe latest version of \u003ccode\u003eInternalException\u003c/code\u003e documented is 2.63.1, with numerous older versions listed dating back to version 2.7.1, all of which are available for reference.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eInternalException\u003c/code\u003e class can be constructed with various parameters, including a message, a cause (Throwable), a status code, a retryable boolean, and error details.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eInternalException\u003c/code\u003e class inherits several methods from the \u003ccode\u003eApiException\u003c/code\u003e, \u003ccode\u003eObject\u003c/code\u003e, and \u003ccode\u003eThrowable\u003c/code\u003e classes, such as \u003ccode\u003egetDomain\u003c/code\u003e, \u003ccode\u003egetErrorDetails\u003c/code\u003e, \u003ccode\u003egetMessage\u003c/code\u003e, and \u003ccode\u003eprintStackTrace\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Exception InternalException (2.69.0)\n\nVersion latestkeyboard_arrow_down\n\n- [2.69.0 (latest)](/java/docs/reference/gax/latest/com.google.api.gax.rpc.InternalException)\n- [2.68.2](/java/docs/reference/gax/2.68.2/com.google.api.gax.rpc.InternalException)\n- [2.67.0](/java/docs/reference/gax/2.67.0/com.google.api.gax.rpc.InternalException)\n- [2.66.0](/java/docs/reference/gax/2.66.0/com.google.api.gax.rpc.InternalException)\n- [2.65.0](/java/docs/reference/gax/2.65.0/com.google.api.gax.rpc.InternalException)\n- [2.63.1](/java/docs/reference/gax/2.63.1/com.google.api.gax.rpc.InternalException)\n- [2.62.0](/java/docs/reference/gax/2.62.0/com.google.api.gax.rpc.InternalException)\n- [2.61.0](/java/docs/reference/gax/2.61.0/com.google.api.gax.rpc.InternalException)\n- [2.60.0](/java/docs/reference/gax/2.60.0/com.google.api.gax.rpc.InternalException)\n- [2.59.1](/java/docs/reference/gax/2.59.1/com.google.api.gax.rpc.InternalException)\n- [2.58.0](/java/docs/reference/gax/2.58.0/com.google.api.gax.rpc.InternalException)\n- [2.57.0](/java/docs/reference/gax/2.57.0/com.google.api.gax.rpc.InternalException)\n- [2.55.0](/java/docs/reference/gax/2.55.0/com.google.api.gax.rpc.InternalException)\n- [2.54.1](/java/docs/reference/gax/2.54.1/com.google.api.gax.rpc.InternalException)\n- [2.53.0](/java/docs/reference/gax/2.53.0/com.google.api.gax.rpc.InternalException)\n- [2.52.0](/java/docs/reference/gax/2.52.0/com.google.api.gax.rpc.InternalException)\n- [2.51.0](/java/docs/reference/gax/2.51.0/com.google.api.gax.rpc.InternalException)\n- [2.50.0](/java/docs/reference/gax/2.50.0/com.google.api.gax.rpc.InternalException)\n- [2.49.0](/java/docs/reference/gax/2.49.0/com.google.api.gax.rpc.InternalException)\n- [2.48.1](/java/docs/reference/gax/2.48.1/com.google.api.gax.rpc.InternalException)\n- [2.47.0](/java/docs/reference/gax/2.47.0/com.google.api.gax.rpc.InternalException)\n- [2.46.1](/java/docs/reference/gax/2.46.1/com.google.api.gax.rpc.InternalException)\n- [2.45.0](/java/docs/reference/gax/2.45.0/com.google.api.gax.rpc.InternalException)\n- [2.43.0](/java/docs/reference/gax/2.43.0/com.google.api.gax.rpc.InternalException)\n- [2.42.0](/java/docs/reference/gax/2.42.0/com.google.api.gax.rpc.InternalException)\n- [2.41.0](/java/docs/reference/gax/2.41.0/com.google.api.gax.rpc.InternalException)\n- [2.39.0](/java/docs/reference/gax/2.39.0/com.google.api.gax.rpc.InternalException)\n- [2.38.0](/java/docs/reference/gax/2.38.0/com.google.api.gax.rpc.InternalException)\n- [2.37.0](/java/docs/reference/gax/2.37.0/com.google.api.gax.rpc.InternalException)\n- [2.36.0](/java/docs/reference/gax/2.36.0/com.google.api.gax.rpc.InternalException)\n- [2.35.0](/java/docs/reference/gax/2.35.0/com.google.api.gax.rpc.InternalException)\n- [2.34.1](/java/docs/reference/gax/2.34.1/com.google.api.gax.rpc.InternalException)\n- [2.33.0](/java/docs/reference/gax/2.33.0/com.google.api.gax.rpc.InternalException)\n- [2.32.1](/java/docs/reference/gax/2.32.1/com.google.api.gax.rpc.InternalException)\n- [2.31.1](/java/docs/reference/gax/2.31.1/com.google.api.gax.rpc.InternalException)\n- [2.30.1](/java/docs/reference/gax/2.30.1/com.google.api.gax.rpc.InternalException)\n- [2.24.0](/java/docs/reference/gax/2.24.0/com.google.api.gax.rpc.InternalException)\n- [2.23.3](/java/docs/reference/gax/2.23.3/com.google.api.gax.rpc.InternalException)\n- [2.22.0](/java/docs/reference/gax/2.22.0/com.google.api.gax.rpc.InternalException)\n- [2.21.0](/java/docs/reference/gax/2.21.0/com.google.api.gax.rpc.InternalException)\n- [2.20.1](/java/docs/reference/gax/2.20.1/com.google.api.gax.rpc.InternalException)\n- [2.19.6](/java/docs/reference/gax/2.19.6/com.google.api.gax.rpc.InternalException)\n- [2.18.7](/java/docs/reference/gax/2.18.7/com.google.api.gax.rpc.InternalException)\n- [2.17.0](/java/docs/reference/gax/2.17.0/com.google.api.gax.rpc.InternalException)\n- [2.16.0](/java/docs/reference/gax/2.16.0/com.google.api.gax.rpc.InternalException)\n- [2.15.0](/java/docs/reference/gax/2.15.0/com.google.api.gax.rpc.InternalException)\n- [2.14.0](/java/docs/reference/gax/2.14.0/com.google.api.gax.rpc.InternalException)\n- [2.13.0](/java/docs/reference/gax/2.13.0/com.google.api.gax.rpc.InternalException)\n- [2.12.2](/java/docs/reference/gax/2.12.2/com.google.api.gax.rpc.InternalException)\n- [2.11.0](/java/docs/reference/gax/2.11.0/com.google.api.gax.rpc.InternalException)\n- [2.10.0](/java/docs/reference/gax/2.10.0/com.google.api.gax.rpc.InternalException)\n- [2.9.0](/java/docs/reference/gax/2.9.0/com.google.api.gax.rpc.InternalException)\n- [2.8.1](/java/docs/reference/gax/2.8.1/com.google.api.gax.rpc.InternalException)\n- [2.7.1](/java/docs/reference/gax/2.7.1/com.google.api.gax.rpc.InternalException) \n\n public class InternalException extends ApiException\n\nException thrown due to internal errors. Means some invariants expected by underlying system has\nbeen broken. If you see one of these errors, something is very broken. \n\nInherited Members\n-----------------\n\n[ApiException.getDomain()](/java/docs/reference/gax/latest/com.google.api.gax.rpc.ApiException#com_google_api_gax_rpc_ApiException_getDomain__) \n[ApiException.getErrorDetails()](/java/docs/reference/gax/latest/com.google.api.gax.rpc.ApiException#com_google_api_gax_rpc_ApiException_getErrorDetails__) \n[ApiException.getMetadata()](/java/docs/reference/gax/latest/com.google.api.gax.rpc.ApiException#com_google_api_gax_rpc_ApiException_getMetadata__) \n[ApiException.getReason()](/java/docs/reference/gax/latest/com.google.api.gax.rpc.ApiException#com_google_api_gax_rpc_ApiException_getReason__) \n[ApiException.getStatusCode()](/java/docs/reference/gax/latest/com.google.api.gax.rpc.ApiException#com_google_api_gax_rpc_ApiException_getStatusCode__) \n[ApiException.isRetryable()](/java/docs/reference/gax/latest/com.google.api.gax.rpc.ApiException#com_google_api_gax_rpc_ApiException_isRetryable__) \n[Object.clone()](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#clone--) \n[Object.equals(Object)](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#equals-java.lang.Object-) \n[Object.finalize()](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#finalize--) \n[Object.getClass()](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#getClass--) \n[Object.hashCode()](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#hashCode--) \n[Object.notify()](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#notify--) \n[Object.notifyAll()](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#notifyAll--) \n[Object.wait()](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#wait--) \n[Object.wait(long)](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#wait-long-) \n[Object.wait(long,int)](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#wait-long-int-) \n[Throwable.addSuppressed(Throwable)](https://docs.oracle.com/javase/8/docs/api/java/lang/Throwable.html#addSuppressed-java.lang.Throwable-) \n[Throwable.fillInStackTrace()](https://docs.oracle.com/javase/8/docs/api/java/lang/Throwable.html#fillInStackTrace--) \n[Throwable.getCause()](https://docs.oracle.com/javase/8/docs/api/java/lang/Throwable.html#getCause--) \n[Throwable.getLocalizedMessage()](https://docs.oracle.com/javase/8/docs/api/java/lang/Throwable.html#getLocalizedMessage--) \n[Throwable.getMessage()](https://docs.oracle.com/javase/8/docs/api/java/lang/Throwable.html#getMessage--) \n[Throwable.getStackTrace()](https://docs.oracle.com/javase/8/docs/api/java/lang/Throwable.html#getStackTrace--) \n[Throwable.getSuppressed()](https://docs.oracle.com/javase/8/docs/api/java/lang/Throwable.html#getSuppressed--) \n[Throwable.initCause(Throwable)](https://docs.oracle.com/javase/8/docs/api/java/lang/Throwable.html#initCause-java.lang.Throwable-) \n[Throwable.printStackTrace()](https://docs.oracle.com/javase/8/docs/api/java/lang/Throwable.html#printStackTrace--) \n[Throwable.printStackTrace(PrintStream)](https://docs.oracle.com/javase/8/docs/api/java/lang/Throwable.html#printStackTrace-java.io.PrintStream-) \n[Throwable.printStackTrace(PrintWriter)](https://docs.oracle.com/javase/8/docs/api/java/lang/Throwable.html#printStackTrace-java.io.PrintWriter-) \n[Throwable.setStackTrace(StackTraceElement\\[\\])](https://docs.oracle.com/javase/8/docs/api/java/lang/Throwable.html#setStackTrace-java.lang.StackTraceElement[]-) \n[Throwable.toString()](https://docs.oracle.com/javase/8/docs/api/java/lang/Throwable.html#toString--)\n\nConstructors\n------------\n\n### InternalException(String message, Throwable cause, StatusCode statusCode, boolean retryable)\n\n public InternalException(String message, Throwable cause, StatusCode statusCode, boolean retryable)\n\n### InternalException(Throwable cause, StatusCode statusCode, boolean retryable)\n\n public InternalException(Throwable cause, StatusCode statusCode, boolean retryable)\n\n### InternalException(Throwable cause, StatusCode statusCode, boolean retryable, ErrorDetails errorDetails)\n\n public InternalException(Throwable cause, StatusCode statusCode, boolean retryable, ErrorDetails errorDetails)"]]