{"record":{"id":"dbb0a93d8001b15e","repo":"quarkusio/quarkus","slug":"unrecognized-option-for-quarkus-bootstrap-misalign","errorCode":null,"errorMessage":"Unrecognized option for quarkus.bootstrap.misaligned-platform-imports: ${misalignedPlatformImports}","messagePattern":"Unrecognized option for quarkus\\.bootstrap\\.misaligned-platform-imports: (.+?)","errorType":"exception","errorClass":"RuntimeException","httpStatus":null,"severity":"error","filePath":"core/deployment/src/main/java/io/quarkus/deployment/builditem/AppModelProviderBuildItem.java","lineNumber":61,"sourceCode":"     * </ul>\n     *\n     * @param config the bootstrap configuration\n     * @return the validated application model\n     * @throws RuntimeException if platform imports are misaligned and the configuration is set to {@code ERROR}\n     *         or if the configuration is unrecognized.\n     */\n    public ApplicationModel validateAndGet(BootstrapConfig config) {\n        final PlatformImports platforms = appModel.getPlatforms();\n        if (platforms != null && !BootstrapConfig.MisalignedPlatformImports.IGNORE.equals(config.misalignedPlatformImports())\n                && !platforms.isAligned()) {\n            switch (config.misalignedPlatformImports()) {\n                case ERROR:\n                    throw new RuntimeException(platforms.getMisalignmentReport());\n                case WARN:\n                    log.warn(platforms.getMisalignmentReport());\n                    break;\n                default:\n                    throw new RuntimeException(\"Unrecognized option for quarkus.bootstrap.misaligned-platform-imports: \"\n                            + config.misalignedPlatformImports());\n            }\n        }\n        return appModel;\n    }\n\n    public Supplier<DependencyInfoProvider> getDependencyInfoProvider() {\n        return depInfoProvider;\n    }\n}\n","sourceCodeStart":43,"sourceCodeEnd":72,"githubUrl":"https://github.com/quarkusio/quarkus/blob/e1c734241f34c7919086ceb4c9262b4a58f6de44/core/deployment/src/main/java/io/quarkus/deployment/builditem/AppModelProviderBuildItem.java#L43-L72","documentation":"quarkus.bootstrap.misaligned-platform-imports only accepts ERROR, WARN, or IGNORE (case as parsed into BootstrapConfig.MisalignedPlatformImports). Any other value reaches the default branch of the switch in validateAndGet and throws a RuntimeException naming the unrecognized option.","triggerScenarios":"Setting quarkus.bootstrap.misaligned-platform-imports in application.properties, build system properties, or environment (QUARKUS_BOOTSTRAP_MISALIGNED_PLATFORM_IMPORTS) to a value that is not error/warn/ignore.","commonSituations":"Typo such as 'Warning', 'silent', or 'false'; quoting mistakes in properties; passing an uppercase-only env var with an unexpected string.","solutions":["Set the property to one of: error, warn, or ignore (case-insensitive as parsed by the enum).","Remove the property entirely to use the default behavior.","Check for stray whitespace or quotes in the configured value in application.properties or the environment."],"exampleFix":"// before (application.properties)\nquarkus.bootstrap.misaligned-platform-imports=silent\n// after\nquarkus.bootstrap.misaligned-platform-imports=warn","handlingStrategy":"validation","validationCode":"String v = System.getProperty(\"quarkus.bootstrap.misaligned-platform-imports\");\nif (v != null && !Set.of(\"error\",\"warn\",\"ignore\").contains(v.toLowerCase())) {\n    throw new IllegalArgumentException(\"Invalid misaligned-platform-imports value: \" + v);\n}","typeGuard":"static boolean isMisalignedOptionValid(String v) {\n    return v == null || v.equalsIgnoreCase(\"error\") || v.equalsIgnoreCase(\"warn\") || v.equalsIgnoreCase(\"ignore\");\n}","tryCatchPattern":null,"preventionTips":["Only use documented values: error, warn, ignore.","Validate properties files after edits; avoid stray quotes/whitespace.","Keep bootstrap options in one documented place in the build."],"tags":["configuration","quarkus","bootstrap","invalid-value"],"backgroundTag":"invalid-config-value","analyzedSha":"e1c734241f34c7919086ceb4c9262b4a58f6de44","analyzedAt":"2026-09-05T17:01:29.979Z","contentChangedAt":"2026-09-05T17:01:29.979Z","schemaVersion":2},"datasetVersion":"2026-09-14T00:17:10.932Z"}