{"record":{"id":"387793f5deee412f","repo":"quarkusio/quarkus","slug":"an-error-occurred-while-processing-resourcename","errorCode":null,"errorMessage":"An error occurred while processing ${resourceName}","messagePattern":"An error occurred while processing (.+?)","errorType":"exception","errorClass":"UncheckedIOException","httpStatus":null,"severity":"error","filePath":"extensions/devui/deployment/src/main/java/io/quarkus/devui/deployment/BuildTimeContentProcessor.java","lineNumber":527,"sourceCode":"                String resourceName = BUILD_TIME_PATH + SLASH + templateName;\n                String fileName = e.getFileName();\n                // TODO: What if we find more than one ?\n                try (InputStream templateStream = cl.getResourceAsStream(resourceName)) {\n                    if (templateStream != null) {\n                        byte[] templateContent = IoUtil.readBytes(templateStream);\n                        // Internal runs on \"naked\" namespace\n                        DevUIContent content = DevUIContent.builder()\n                                .fileName(fileName)\n                                .template(templateContent)\n                                .addData(data)\n                                .descriptions(descriptions)\n                                .mcpDefaultEnables(mcpDefaultEnabled)\n                                .contentTypes(contentTypes)\n                                .build();\n                        contentPerExtension.add(content);\n                    }\n                } catch (IOException ioe) {\n                    throw new UncheckedIOException(\"An error occurred while processing \" + resourceName, ioe);\n                }\n            }\n            buildTimeContentProducer.produce(new StaticContentBuildItem(\n                    StaticContentBuildItem.DEV_UI, contentPerExtension));\n        }\n    }\n\n    /**\n     * Creates json data that is available in Javascript\n     */\n    @BuildStep(onlyIf = IsLocalDevelopment.class)\n    void createBuildTimeData(BuildProducer<BuildTimeConstBuildItem> buildTimeConstProducer,\n            BuildProducer<ThemeVarsBuildItem> themeVarsProducer,\n            CurateOutcomeBuildItem curateOutcomeBuildItem,\n            List<InternalPageBuildItem> internalPages,\n            ExtensionsBuildItem extensionsBuildItem,\n            NonApplicationRootPathBuildItem nonApplicationRootPathBuildItem,\n            LaunchModeBuildItem launchModeBuildItem,","sourceCodeStart":509,"sourceCodeEnd":545,"githubUrl":"https://github.com/quarkusio/quarkus/blob/e1c734241f34c7919086ceb4c9262b4a58f6de44/extensions/devui/deployment/src/main/java/io/quarkus/devui/deployment/BuildTimeContentProcessor.java#L509-L545","documentation":"During build, BuildTimeContentProcessor.loadAllBuildTimeTemplates() reads Dev UI static build-time content templates from the classpath by resourceName. If reading a template (or other classpath resource) raises an IOException, it is rethrown as an UncheckedIOException with this message. It signals a corrupted or unreadable Dev UI resource bundled with an extension.","triggerScenarios":"An IOException occurs while loading a Dev UI build-time template/resource during augmentation — e.g. the resource exists in the resource listing but cannot be opened from a broken/partially-built JAR or damaged local Maven repository entry.","commonSituations":"Corrupted artifacts in ~/.m2/repository after an interrupted build; a fat/duplicate classpath entry shadowing resources; building inside a container with a stale dependency snapshot; newly added extension whose Dev UI assets failed to package.","solutions":["Clear the corrupted dependency: delete the relevant extension artifact from ~/.m2/repository and rebuild with ./mvnw install -f extensions/<name>/","Run a clean build (./mvnw clean install -Dquickly) to regenerate packaged Dev UI assets","Check the cause (ioe) for the exact resource path and containing JAR to identify the broken artifact","Update/rebuild the extension module that owns the failing resourceName"],"exampleFix":null,"handlingStrategy":"try-catch","validationCode":null,"typeGuard":null,"tryCatchPattern":"try {\n    loadAllBuildTimeTemplates(...);\n} catch (UncheckedIOException e) {\n    log.error(\"Broken Dev UI resource: \" + e.getMessage() + \" — rebuild the owning extension JAR\", e);\n    // e.g. delete artifact from ~/.m2 and rebuild\n}","preventionTips":["Run clean builds after dependency version changes","Watch for interrupted downloads corrupting ~/.m2 artifacts","Validate packaged extension JARs contain their Dev UI assets before publishing"],"tags":["devui","build-time","ioexception","classpath"],"backgroundTag":"unreadable-classpath-resource","analyzedSha":"e1c734241f34c7919086ceb4c9262b4a58f6de44","analyzedAt":"2026-09-05T17:01:29.979Z","contentChangedAt":"2026-09-05T17:01:29.979Z","schemaVersion":2},"datasetVersion":"2026-09-12T22:17:10.623Z"}