{"record":{"id":"e75427edf8d6ccdb","repo":"eclipse-vertx/vert.x","slug":"unexpected-nested-url-nestedurl","errorCode":null,"errorMessage":"Unexpected nested url : ${nestedURL}","messagePattern":"Unexpected nested url : (.+?)","errorType":"exception","errorClass":"VertxException","httpStatus":null,"severity":"error","filePath":"vertx-core/src/main/java/io/vertx/core/file/impl/FileResolverImpl.java","lineNumber":360,"sourceCode":"                  Path relative = path.relativize(dir);\n                  cache.cacheDir(relative.toString());\n                  return FileVisitResult.CONTINUE;\n                }\n                @Override\n                public FileVisitResult visitFile(Path file, BasicFileAttributes attrs) throws IOException {\n                  Path relative = path.relativize(file);\n                  cache.cacheFile(relative.toString(), file.toFile(), false);\n                  return FileVisitResult.CONTINUE;\n                }\n              });\n            } else {\n              // jar:file:/path/to/nesting.jar!/path/to/nested.jar\n              try (ZipFile zip = new ZipFile(root)) {\n                extractFilesFromJarFile(zip, fileName);\n              }\n            }\n          } else {\n            throw new VertxException(\"Unexpected nested url : \" + nestedURL);\n          }\n          break;\n        default:\n          throw new VertxException(\"Nesting more than two levels is not supported\");\n      }\n    } catch (IOException e) {\n      throw new VertxException(FileSystemImpl.getFileAccessErrorMessage(\"unpack\", url.toString()), e);\n    }\n    return cache.getFile(fileName);\n  }\n\n  /**\n   * Extract a subset of the entries to the cache.\n   */\n  private void extractFilesFromJarFile(ZipFile zip, String entryFilter) throws IOException {\n    Enumeration<? extends ZipEntry> entries = zip.entries();\n    while (entries.hasMoreElements()) {\n      ZipEntry entry = entries.nextElement();","sourceCodeStart":342,"sourceCodeEnd":378,"githubUrl":"https://github.com/eclipse-vertx/vert.x/blob/fb308bd8c3f12c79f4ae89bef67fadf6c80d036e/vertx-core/src/main/java/io/vertx/core/file/impl/FileResolverImpl.java#L342-L378","documentation":"Parsing guard when unpacking a jar: URL: the nested URL extracted from the outer jar URL has an unexpected form that cannot be processed further. The offending nested URL string is included in the message; this signals a malformed jar URL rather than user configuration error.","triggerScenarios":"Thrown at vertx-core/src/main/java/io/vertx/core/file/impl/FileResolverImpl.java:360 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Check the packaging/classpath for a malformed jar URL (e.g. invalid nesting like jar:jar:file:...)","Repackage or reference the resource with a plain file: or single-level jar: URL"],"exampleFix":null,"handlingStrategy":"type-guard","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"fb308bd8c3f12c79f4ae89bef67fadf6c80d036e","analyzedAt":"2026-09-06T11:37:12.241Z","contentChangedAt":"2026-09-06T11:37:12.241Z","schemaVersion":2},"datasetVersion":"2026-09-14T00:17:10.932Z"}