{"record":{"id":"2e45c1b7c3b7c5d0","repo":"apache/hadoop","slug":"could-not-instantiate-kmsprovider","errorCode":null,"errorMessage":"Could not instantiate KMSProvider.","messagePattern":"Could not instantiate KMSProvider\\.","errorType":"exception","errorClass":"IOException","httpStatus":null,"severity":"error","filePath":"hadoop-common-project/hadoop-common/src/main/java/org/apache/hadoop/crypto/key/kms/KMSClientProvider.java","lineNumber":322,"sourceCode":"        KMSClientProvider[] providers =\n            createProviders(conf, origUrl, port, hostsPart);\n        return new LoadBalancingKMSClientProvider(providerUri, providers, conf);\n      }\n      return null;\n    }\n\n    private KMSClientProvider[] createProviders(Configuration conf,\n        URL origUrl, int port, String hostsPart) throws IOException {\n      String[] hosts = hostsPart.split(\";\");\n      KMSClientProvider[] providers = new KMSClientProvider[hosts.length];\n      for (int i = 0; i < hosts.length; i++) {\n        try {\n          providers[i] =\n              new KMSClientProvider(\n                  new URI(\"kms\", origUrl.getProtocol(), hosts[i], port,\n                      origUrl.getPath(), null, null), conf);\n        } catch (URISyntaxException e) {\n          throw new IOException(\"Could not instantiate KMSProvider.\", e);\n        }\n      }\n      return providers;\n    }\n  }\n\n  private URL kmsUrl;\n  private SSLFactory sslFactory;\n  private ConnectionConfigurator configurator;\n  private DelegationTokenAuthenticatedURL.Token authToken;\n  private final int authRetry;\n\n  @Override\n  public String toString() {\n    final StringBuilder sb = new StringBuilder(\"KMSClientProvider[\");\n    sb.append(kmsUrl).append(\"]\");\n    return sb.toString();\n  }","sourceCodeStart":304,"sourceCodeEnd":340,"githubUrl":"https://github.com/apache/hadoop/blob/2add9630210752f88ceb1bb74eb65e37bf41da8e/hadoop-common-project/hadoop-common/src/main/java/org/apache/hadoop/crypto/key/kms/KMSClientProvider.java#L304-L340","documentation":"Error \"Could not instantiate KMSProvider.\" thrown in apache/hadoop.","triggerScenarios":"Raised at runtime when the documented precondition or configuration requirement for this operation is violated.","commonSituations":"Misconfigured or missing property, invalid user input, or calling the API before its prerequisites are met.","solutions":["Check the KMS provider configuration; the wrapped exception shows why instantiation failed."],"exampleFix":"Verify the kms URL and credentials in the configuration.","handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"2add9630210752f88ceb1bb74eb65e37bf41da8e","analyzedAt":"2026-08-22T19:55:07.957Z","schemaVersion":2},"datasetVersion":"2026-08-22T20:17:22.307Z"}