{"record":{"id":"c45757cde37e57b9","repo":"sgl-project/sglang","slug":"deepep-v2-moe-has-not-validated-fused-shared-exper","errorCode":null,"errorMessage":"DeepEP v2 MoE has not validated fused shared experts yet. Remove --enforce-shared-experts-fusion when using --moe-a2a-backend deepep_v2.","messagePattern":"DeepEP v2 MoE has not validated fused shared experts yet\\. Remove --enforce-shared-experts-fusion when using --moe-a2a-backend deepep_v2\\.","errorType":"validation","errorClass":"ValueError","httpStatus":null,"severity":"error","filePath":"python/sglang/srt/server_args.py","lineNumber":7730,"sourceCode":"                self._declare(\"_handle_a2a_moe\", moe_runner_backend=\"deep_gemm\")\n                logger.warning(\n                    \"DeepEP v2 MoE: resolved --moe-runner-backend auto -> deep_gemm.\"\n                )\n            elif resolved_runner != \"deep_gemm\":\n                raise ValueError(\n                    \"DeepEP v2 MoE currently supports only \"\n                    f\"--moe-runner-backend deep_gemm. Got {resolved_runner!r}. \"\n                    \"Add a runner adapter before enabling DeepEP v2 with other \"\n                    \"MoE runners.\"\n                )\n            if cfg.enable_two_batch_overlap or cfg.enable_single_batch_overlap:\n                raise ValueError(\n                    \"DeepEP v2 MoE has not implemented the TBO/SBO overlap hooks yet. \"\n                    \"Disable --enable-two-batch-overlap and \"\n                    \"--enable-single-batch-overlap when using --moe-a2a-backend deepep_v2.\"\n                )\n            if cfg.enforce_shared_experts_fusion:\n                raise ValueError(\n                    \"DeepEP v2 MoE has not validated fused shared experts yet. \"\n                    \"Remove --enforce-shared-experts-fusion when using \"\n                    \"--moe-a2a-backend deepep_v2.\"\n                )\n            # Prefill reads host counts and is not graph-capturable.\n            self._declare(\n                \"_handle_a2a_moe\",\n                cuda_graph_config=with_phase(\n                    cfg.cuda_graph_config, Phase.PREFILL, backend=Backend.DISABLED\n                ),\n            )\n            logger.warning(\n                f\"DeepEP v2 MoE is enabled. The expert parallel size is adjusted to be the same as the tensor parallel size[{cfg.tp_size}].\"\n            )\n            logger.warning(\n                \"DeepEP v2 MoE is using deepep_v2_mode=%s. This controls \"\n                \"ElasticBuffer direct/hybrid mode and is independent from \"\n                \"--deepep-mode normal/low_latency. DeepEP v2 MoE enables the \"","sourceCodeStart":7712,"sourceCodeEnd":7748,"githubUrl":"https://github.com/sgl-project/sglang/blob/0132848349585cfe6aae51c4941cbae872505f8a/python/sglang/srt/server_args.py#L7712-L7748","documentation":"Raised when deepep_v2 is combined with --enforce-shared-experts-fusion. Fused shared experts have not been validated against the DeepEP v2 path, so the resolver rejects it rather than risk silent numerical issues. Note some waterfill tests force shared experts fusion, making this combo easy to hit in test configs.","triggerScenarios":"Launching with --moe-a2a-backend deepep_v2 and --enforce-shared-experts-fusion set in the resolved config.","commonSituations":"Deploying a DeepSeek-style model where shared-experts fusion was previously enforced for perf; test harnesses that set the fusion flag globally for all backends.","solutions":["Remove --enforce-shared-experts-fusion when using deepep_v2","Use --moe-a2a-backend deepep if fused shared experts are required"],"exampleFix":"# before\n--moe-a2a-backend deepep_v2 --enforce-shared-experts-fusion\n# after\n--moe-a2a-backend deepep_v2","handlingStrategy":"validation","validationCode":"if a2a_backend == \"deepep_v2\" and enforce_shared_experts_fusion:\n    enforce_shared_experts_fusion = False","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Don't set --enforce-shared-experts-fusion globally in test harnesses that sweep a2a backends","Scope fusion flags to validated backend combos only"],"tags":["deepep","shared-experts","fusion","moe","server-args"],"backgroundTag":"unsupported-configuration-combo","analyzedSha":"0132848349585cfe6aae51c4941cbae872505f8a","analyzedAt":"2026-08-28T05:10:05.995Z","schemaVersion":2},"datasetVersion":"2026-08-28T06:17:29.519Z"}