{"record":{"id":"8b735193a01abb17","repo":"sgl-project/sglang","slug":"h3-conditioning-projection-has-neither-w-nor-an-ml","errorCode":null,"errorMessage":"H3 conditioning projection has neither W nor an MLP","messagePattern":"H3 conditioning projection has neither W nor an MLP","errorType":"exception","errorClass":"ValueError","httpStatus":null,"severity":"critical","filePath":"python/sglang/multimodal_gen/runtime/models/encoders/minimax_h3_qwen3vl.py","lineNumber":152,"sourceCode":"            if weight.ndim != 2 or int(weight.shape[1]) != layer_input_dim:\n                raise ValueError(\n                    f\"H3 conditioning projection {weight_name} cannot follow \"\n                    f\"width {layer_input_dim}: got {tuple(weight.shape)}\"\n                )\n            if bias is not None and tuple(bias.shape) != (int(weight.shape[0]),):\n                raise ValueError(\n                    f\"H3 conditioning projection {bias_name} has shape \"\n                    f\"{tuple(bias.shape)}, expected ({int(weight.shape[0])},)\"\n                )\n            layers.append(_FrozenLinear(weight, bias))\n            layer_input_dim = int(weight.shape[0])\n        if tensors:\n            raise ValueError(\n                \"H3 conditioning projection contains unsupported tensors: \"\n                f\"{sorted(tensors)}\"\n            )\n        if self.weight is None and not layers:\n            raise ValueError(\"H3 conditioning projection has neither W nor an MLP\")\n        if layers and layer_input_dim != self.output_dim:\n            raise ValueError(\n                f\"H3 conditioning projection MLP outputs width {layer_input_dim}, \"\n                f\"expected {self.output_dim}\"\n            )\n        if self.weight is not None and tuple(self.weight.shape) != (\n            self.input_dim,\n            self.output_dim,\n        ):\n            raise ValueError(\n                \"H3 conditioning projection W has shape \"\n                f\"{tuple(self.weight.shape)}, expected \"\n                f\"({self.input_dim}, {self.output_dim})\"\n            )\n        self.layers = nn.ModuleList(layers)\n\n    def forward(self, hidden_states: torch.Tensor) -> torch.Tensor:\n        if int(hidden_states.shape[-1]) != self.input_dim:","sourceCodeStart":134,"sourceCodeEnd":170,"githubUrl":"https://github.com/sgl-project/sglang/blob/0132848349585cfe6aae51c4941cbae872505f8a/python/sglang/multimodal_gen/runtime/models/encoders/minimax_h3_qwen3vl.py#L134-L170","documentation":"The conditioning projection module was built with neither a direct W matrix nor any MLP layers — i.e. the provided tensors contained nothing usable for projection. This is a hard configuration error: the module cannot compute anything.","triggerScenarios":"MiniMaxH3ConditioningProjection constructed with an empty state dict, or one containing only normalization statistics (mean/std) and no weight matrices.","commonSituations":"Empty or wrong safetensors file passed via --component-paths.conditioning_projection; pointing at a metadata-only file; the projection tensors were filtered out by a prefix handler.","solutions":["Verify the file actually contains projection weight tensors (load and list keys)","Point --component-paths.conditioning_projection at the correct projection checkpoint","If using a >=32B model where the projection is built-in, remove the override so the built-in path is used"],"exampleFix":null,"handlingStrategy":"validation","validationCode":"sd = torch.load(proj_path)\nassert any(k.endswith(\"weight\") for k in sd), \"projection checkpoint has no weights\"","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Check the file is non-trivial in size and contains weight keys before passing it","Keep official projection checkpoints alongside their model release"],"tags":["minimax-h3","conditioning-projection","empty-checkpoint"],"backgroundTag":"missing-model-weights","analyzedSha":"0132848349585cfe6aae51c4941cbae872505f8a","analyzedAt":"2026-08-28T05:10:05.995Z","schemaVersion":2},"datasetVersion":"2026-08-28T06:17:29.519Z"}