{"record":{"id":"514cee3121a12609","repo":"sgl-project/sglang","slug":"failed-to-load-customized-component-name-native","errorCode":null,"errorMessage":"Failed to load customized {component_name}; native fallback is disabled for this component configuration.","messagePattern":"Failed to load customized (.+?); native fallback is disabled for this component configuration\\.","errorType":"error_code","errorClass":"RuntimeError","httpStatus":null,"severity":"critical","filePath":"python/sglang/multimodal_gen/runtime/loader/component_loaders/component_loader.py","lineNumber":282,"sourceCode":"        try:\n            component = self._load_customized_with_context(\n                component_model_path,\n                server_args,\n                component_name,\n                attn_backend,\n                component_attn_name,\n                self.allow_global_attention_backend_fallback,\n            )\n            source = \"sgl-diffusion\"\n        except (ComponentCheckpointUnsupportedError, ComponentResidencyError):\n            raise\n        except Exception as e:\n            native_loader_required = isinstance(e, NativeComponentLoaderRequired)\n            if self.should_raise_customized_load_error(server_args, component_name):\n                if native_loader_required:\n                    raise\n                traceback.print_exc()\n                raise RuntimeError(\n                    f\"Failed to load customized {component_name}; native fallback \"\n                    \"is disabled for this component configuration.\"\n                ) from e\n            if native_loader_required:\n                logger.info(\"%s\", e)\n            elif \"Unsupported model architecture\" in str(e):\n                logger.info(\n                    f\"Component: {component_name} doesn't have a customized version yet, using native version\"\n                )\n            else:\n                traceback.print_exc()\n                logger.error(\n                    f\"Error while loading customized {component_name}, falling back to native version\"\n                )\n            # fallback to native version\n            component = self._load_native_with_context(\n                component_model_path,\n                server_args,","sourceCodeStart":264,"sourceCodeEnd":300,"githubUrl":"https://github.com/sgl-project/sglang/blob/0132848349585cfe6aae51c4941cbae872505f8a/python/sglang/multimodal_gen/runtime/loader/component_loaders/component_loader.py#L264-L300","documentation":"load() attempts the customized loader first; if it raises and should_raise_customized_load_error() says native fallback is disabled for this configuration, the original exception is printed and re-raised wrapped as RuntimeError with this message (native_loader_required exceptions are re-raised unchanged).","triggerScenarios":"The customized load path throws any non-NativeComponentLoaderRequired exception while the component's policy forbids falling back to the native transformers/diffusers loader (e.g. quantization or precision settings that make fallback unsafe).","commonSituations":"A corrupted or misconfigured component checkpoint combined with server args that disable fallback (e.g. explicit precision/quantization for the component); customized loader bugs for newly added components.","solutions":["Read the printed traceback above the RuntimeError — the root cause is the actual load failure; fix that first (missing files, bad config keys, dtype issues)","Verify the component directory, config.json, and weight files are complete and match the model revision","If fallback is acceptable, remove the server-arg settings (e.g. component_quantizations/precision overrides) that disabled native fallback"],"exampleFix":null,"handlingStrategy":"try-catch","validationCode":null,"typeGuard":null,"tryCatchPattern":"try:\n    loader.load(component_model_path, server_args, name)\nexcept RuntimeError as e:\n    if \"native fallback is disabled\" in str(e):\n        # root cause is in __cause__; inspect before retrying\n        log.exception(\"customized load failed\", exc_info=e.__cause__)\n    raise","preventionTips":["Validate component checkpoints (config + weights) before startup","Avoid precision/quantization overrides that disable safe native fallback","Treat this wrapper as a pointer: always debug the underlying traceback printed above it"],"tags":["model-loading","fallback","quantization","wrapper-exception"],"backgroundTag":"component-load-failure","analyzedSha":"0132848349585cfe6aae51c4941cbae872505f8a","analyzedAt":"2026-08-28T05:10:05.995Z","schemaVersion":2},"datasetVersion":"2026-08-28T06:17:29.519Z"}