执行摘要

• 一句话：HybridAttnBackend 补 max_context_len，修复 EAGLE verify 崩溃
• 推荐动作：值得快速浏览：一行修复但指出了 hybrid 包装层属性透传的设计约定。可结合 needs_cpu_seq_lens 的聚合委托逻辑一起阅读，理解 wrapper 需要显式转发哪些叶子后端属性；建议未来为 wrapper 类补充属性透传清单测试，防止同类遗漏。

功能与动机

PR body 明确指出：当两个子后端都设置 needs_cpu_seq_lens=False 时，EAGLE verify fallback 会读取 attn_backend.max_context_len，而 hybrid wrapper 没有定义该属性，导致 AttributeError 崩溃。作者参照仓库中所有叶子后端都定义 self.max_context_len 的惯例，在包装层补齐该属性。

实现拆解

1. 变更入口：python/sglang/srt/layers/attention/hybrid_attn_backend.py 的 HybridAttnBackend.__init__，在已有的 needs_cpu_seq_lens 聚合逻辑之后新增 self.max_context_len = model_runner.model_config.context_len，使包装层与所有叶子后端保持属性契约一致。
2. 修复原因：当 needs_cpu_seq_lens=False 时，EAGLE verify fallback 直接读取 attn_backend.max_context_len，此前 wrapper 未定义该属性，必然触发 AttributeError；补齐后该路径可正常取得模型上下文长度。
3. 测试配套：三个测试文件（test_attention_backend_setup.py、test_trtllm_mha_graph_metadata.py、test_dflash_overlap_hostsync.py）均为 fake model_runner 增加 model_config=SimpleNamespace(context_len=2048)，避免构造 HybridAttnBackend 时因新读取逻辑再次崩溃，覆盖了后端装配、TRTLLM 图元数据、DFLASH 主机同步三条回归路径。
4. 演进过程：4 个 commit 中前两个为核心修复与 CI 重跑，后两个分别补齐测试 stub，说明首次 CI 暴露了 fake runner 缺字段的连带问题。

关键文件：

• python/sglang/srt/layers/attention/hybrid_attn_backend.py（模块 注意力后端；类别 source；类型 core-logic；符号 HybridAttnBackend.init）: 核心修复文件：在 HybridAttnBackend.init 中新增 max_context_len 属性透传，解决 EAGLE verify fallback 读取该属性时的 AttributeError 崩溃。
• test/registered/unit/model_executor/model_runner_components/test_attention_backend_setup.py（模块 后端装配；类别 test；类型 test-coverage；符号 test_split_full_attention_applies_model_wrapper_once）: 后端装配主测试：为 fake model_runner 补 model_config，验证 HybridAttnBackend 构造路径不再因读取 context_len 崩溃。
• test/registered/attention/test_trtllm_mha_graph_metadata.py（模块 图元数据；类别 test；类型 test-coverage；符号 test_hybrid_wrappers_forward_in_graph_hook）: TRTLLM MHA 图元数据测试：fake runner 补 model_config，确保 HybridAttnBackend 在测试中可正常构造。
• test/registered/unit/spec/test_dflash_overlap_hostsync.py（模块 投机解码；类别 test；类型 test-coverage；符号 TestHybridNeedsCpuSeqLens.test_delegation）: DFLASH 投机解码测试：fake runner 补 model_config，覆盖另一条使用 HybridAttnBackend 的 speculative 路径。

关键符号：HybridAttnBackend.init

关键源码片段

python/sglang/srt/layers/attention/hybrid_attn_backend.py

核心修复文件：在 HybridAttnBackend.init 中新增 max_context_len 属性透传，解决 EAGLE verify fallback 读取该属性时的 AttributeError 崩溃。

class HybridAttnBackend(AttentionBackend):
    """Support different backends for prefill and decode."""
​
    def __init__(
        self,
        model_runner: ModelRunner,
        prefill_backend: AttentionBackend,
        decode_backend: AttentionBackend,
    ):
        self.model_runner = model_runner
        self.prefill_backend = prefill_backend
        self.decode_backend = decode_backend
        self.data_type = model_runner.kv_cache_dtype
        self.token_to_kv_pool = model_runner.token_to_kv_pool
        self.req_to_token_pool = model_runner.req_to_token_pool
        self.spec_attn_is_decode = (
            model_runner.server_args.speculative_attention_mode == "decode"
        )
        self.spec_attn_is_prefill = (
            model_runner.server_args.speculative_attention_mode == "prefill"
        )
​
        # needs_cpu_seq_lens 必须聚合两个子后端的结果；
        # 若直接沿用基类默认值 True，即使两个子后端都不需要 CPU 上的 seq_lens，
        # 也会强制每步做 seq_lens 的 D2H 拷贝 + 主机同步，拖慢 decode 路径。
        self.needs_cpu_seq_lens = (
            prefill_backend.needs_cpu_seq_lens or decode_backend.needs_cpu_seq_lens
        )
​
        # max_context_len 是所有叶子后端都会暴露的属性；
        # EAGLE verify fallback 在 needs_cpu_seq_lens=False 时会直接读取它，
        # hybrid 包装层此前未定义，导致 AttributeError 崩溃（本 PR 修复的崩溃点）。
        self.max_context_len = model_runner.model_config.context_len

评论区精华

该 PR 没有实质的 review 讨论：review 评论为 0，issue 内仅有 Gemini Code Assist 停止服务的公告和作者两次 CI 重跑指令（/tag-run-ci-label、/tag-and-rerun-ci extra）。合并者 ispobock 直接 APPROVED，说明改动被认定为低风险。核心设计决策（照叶子后端模式补齐属性透传）已在 PR body 中通过代码搜索链接明确表达。

• 暂无高价值评论线程

风险与影响

• 风险：修复本身极低风险：只新增一个属性赋值。但需注意两点：一是该属性直接读取 model_runner.model_config.context_len，若 model_config 缺失或字段改名会再次抛 AttributeError；二是三处测试仅覆盖“构造不崩溃”，未覆盖 EAGLE verify fallback 真实读取 max_context_len 的行为，且测试用假值 2048 不代表真实模型上下文长度。
• 影响：影响面集中在 HybridAttnBackend + 投机验证路径：此前该配置组合会确定性崩溃（AttributeError），修复后 EAGLE verify fallback 可正常读取 max_context_len；对纯 prefill 或单后端路径无影响。团队层面，该修复提示 hybrid wrapper 需要与叶子后端保持属性契约一致，未来新增叶子后端属性时应同步检查 wrapper。
• 风险标记：叶后端属性透传不全, 测试仅覆盖构造路径, EAGLE verify 路径触发

关联脉络

• PR #32920 [Spec] Compact the target-verify mask when nothing reads it: 同改 hybrid_attn_backend.py，且都在 speculative verify 路径上动刀；本 PR 修复的 max_context_len 缺失正是在该路径上暴露的。
• PR #32595 Support SGLANG_SIMULATE_ACC_LEN for DFLASH: 同属 speculative-decoding 链路，与 test_dflash_overlap_hostsync.py 覆盖的 DFLASH 路径相关。