执行摘要

• 一句话：弃用 Mamba 缓存模式 "all" 并为 MRV2 添加回退至 MRV1 的支持检查。
• 推荐动作：此 PR 变更范围小、逻辑清晰，旨在解决一个明确的配置兼容性问题。作为 v0.29.0 的 cherry-pick，它具有较高的合并优先级。建议精读以了解 vLLM 如何处理新旧模型运行器（MRV1/MRV2）之间的特性支持差异和配置回退逻辑。这是一个良好的工程实践案例：通过配置验证和兼容性检查来管理功能弃用。

功能与动机

根据 PR body 的表述，弃用的原因是 Mamba 缓存模式 "all" 未在 MRV2 中实现。这意味着如果用户配置了该模式但尝试使用 MRV2，系统可能会出现未定义行为或错误。因此，需要主动弃用该模式，并在 MRV2 的特性检查中将其拦截，引导用户回退到已实现该模式的 MRV1。

实现拆解

1. 配置验证弃用警告：在 vllm/config/cache.py 的 CacheConfig 类中新增了一个 Pydantic 字段验证器 _validate_mamba_cache_mode。当用户配置 mamba_cache_mode="all" 时，此验证器会触发，使用 logger.warning_once 输出明确的弃用信息，告知用户该模式将在未来版本中移除，并引导其提交 issue 反馈问题。
2. MRV2 特性兼容性检查：在 vllm/config/vllm.py 的 VllmConfig._get_v2_model_runner_unsupported_features 方法中，新增了一个条件判断。如果 cache_config.mamba_cache_mode 的值为 "all"，则将字符串 "mamba cache mode 'all'" 添加到不支持特性列表中。这确保了在使用 MRV2 时，若配置了该模式，引擎会识别出此特性不支持，并触发回退逻辑，选择使用 MRV1 运行模型。
3. 测试配套更新：在 tests/model_executor/test_routed_experts_capture.py 的测试用例 test_v2_model_runner_accepts_routed_experts 中，更新了用于模拟配置的 SimpleNamespace 对象，为 cache_config 添加了 mamba_cache_mode="none" 属性。这是为了适配新的验证逻辑，确保在测试 MRV2 特性兼容性时，模拟配置是完整的，避免因缺少该属性而导致测试失败。

关键文件：

• vllm/config/cache.py（模块 配置管理；类别 source；类型 core-logic；符号 _validate_mamba_cache_mode）: 核心源码文件，新增了 _validate_mamba_cache_mode 验证器，是弃用警告的直接实现点。
• vllm/config/vllm.py（模块 配置管理；类别 source；类型 core-logic）: MRV2 特性兼容性检查逻辑在此文件，新增了对 "all" 缓存模式的检查，决定是否回退到 MRV1。
• tests/model_executor/test_routed_experts_capture.py（模块 测试覆盖；类别 test；类型 test-coverage）: 测试配套更新，确保在测试 MRV2 特性兼容性时，模拟的配置对象包含了新增的 mamba_cache_mode 属性，避免测试因属性缺失而失败。

关键符号：_validate_mamba_cache_mode, _get_v2_model_runner_unsupported_features

关键源码片段

vllm/config/vllm.py

MRV2 特性兼容性检查逻辑在此文件，新增了对 "all" 缓存模式的检查，决定是否回退到 MRV1。

def _get_v2_model_runner_unsupported_features(self) -> list[str]:
    unsupported: list[str] = []
    # ... 其他不支持特性检查 ...
​
    if self.cache_config.kv_sharing_fast_prefill:
        # Will be added by https://github.com/vllm-project/vllm/pull/35045
        unsupported.append("KV sharing fast prefill")
​
    # 新增检查：如果配置了已弃用的 "all" 模式，则标记为 MRV2 不支持，
    # 从而强制引擎回退到 MRV1 运行。
    if self.cache_config.mamba_cache_mode == "all":
        unsupported.append("mamba cache mode 'all'")
​
    return unsupported

评论区精华

此次 PR 的讨论较少，主要集中在 CI 触发和审批上。开发者 ZJY0516 的审批评论 "Thanks for doing this!" 表明社区认可了此次弃用操作的必要性。自动化评论机器人 claude[bot] 的提示属于标准流程提醒，不涉及技术讨论。

• 暂无高价值评论线程

风险与影响

• 风险：用户升级兼容性：已配置 mamba_cache_mode="all" 的用户在升级到包含此 PR 的版本后，会收到弃用警告。虽然当前功能不受影响（系统会回退到 MRV1），但需要规划在未来版本中彻底移除该模式，届时会存在 breaking change。
  MRV2 回退逻辑：变更在 MRV2 的特性检查中增加了新的阻断条件。如果 m_cache_mode 的比较逻辑或未来枚举值发生变更，此检查可能需要同步更新，否则可能导致 MRV2 错误地被启用或禁用。

• 影响：用户影响：直接影响使用了 mamba_cache_mode="all" 的用户，他们将在日志中看到一条明确的弃用警告。系统行为保持不变（回退到 MRV1），因此对用户体验的影响是信息层面的。
  系统影响：增强了系统在 MRV1 和 MRV2 间选择运行器的健壮性，避免了因配置了未实现特性而导致的潜在故障。这是一个预防性的、面向维护的变更。
  团队影响：为 Mamba 缓存模式的未来清理工作奠定了基础，明确了技术债务。此 PR 是 v0.29.0 的 cherry-pick，表明团队认为此修复具有及时性，需要纳入小版本发布。

• 风险标记：配置弃用引入

关联脉络

• 暂无明显关联 PR