执行摘要

• 一句话：XPU Graph 启用时输出实验性警告
• 推荐动作：该 PR 设计简洁明确，值得作为 XPU 平台文档的补充，建议用户关注警告中的限制说明。对理解 XPU 平台的当前状态有参考价值。

功能与动机

XPU Graph 功能处于实验阶段，存在多个已知限制（单 GPU、注意力模式、显存开销），用户若未经说明便启用可能会遇到性能下降或 OOM 等问题。PR 作者在 body 中明确列出了需要警告的三点限制，旨在提升用户体验，避免不必要的调试成本。

实现拆解

1. 定位到配置检查入口：在 vllm/platforms/xpu.py 的 check_and_update_config 类方法中，当 XPU Graph 被启用时（即 supports_xpu_graph() 返回 True 且 VLLM_XPU_ENABLE_XPU_GRAPH=1），原先该分支没有任何操作。
2. 新增 else 分支日志：在原有 if not supports_xpu_graph() 和 elif not envs.VLLM_XPU_ENABLE_XPU_GRAPH 之后，增加 else 分支，调用 logger.warning_once 输出三条限制的警告消息。
3. 仅改动一个文件：无其他测试、配置或部署配套变更。

关键文件：

• vllm/platforms/xpu.py（模块 平台适配；类别 source；类型 core-logic）: 该文件是 XPU 平台核心配置入口，本次 PR 在该文件的 check_and_update_config 方法中增加了 XPU Graph 启用时的警告日志，是唯一变更的文件。

关键符号：未识别

关键源码片段

vllm/platforms/xpu.py

该文件是 XPU 平台核心配置入口，本次 PR 在该文件的 check_and_update_config 方法中增加了 XPU Graph 启用时的警告日志，是唯一变更的文件。

# vllm/platforms/xpu.py (modified)
​
@classmethod
def check_and_update_config(cls, vllm_config: VllmConfig) -> None:
    # lazy import to avoid circular import
    from vllm.config import CUDAGraphMode
​
    compilation_config = vllm_config.compilation_config
    if compilation_config.compile_sizes is None:
        compilation_config.compile_sizes = []
​
    # lazy import to avoid circular import
    from vllm.utils.torch_utils import supports_xpu_graph
​
    if not supports_xpu_graph():
        compilation_config.cudagraph_mode = CUDAGraphMode.NONE
        logger.warning_once(
            "XPU Graph is not supported in the current PyTorch version, "
            "disabling cudagraph_mode."
        )
    elif not envs.VLLM_XPU_ENABLE_XPU_GRAPH:
        compilation_config.cudagraph_mode = CUDAGraphMode.NONE
        logger.warning_once(
            "XPU Graph is disabled by environment variable, "
            "please set VLLM_XPU_ENABLE_XPU_GRAPH=1 to enable it."
        )
    else:
        # 新增警告：XPU Graph 启用时的限制提示
        logger.warning_once(
            "XPU Graph support is experimental and has known limitations: "
            "(1) only single-GPU execution is supported; "
            "(2) FLASH_ATTN supports PIECEWISE mode only; use TRITON_ATTN "
            "for FULL mode; "
            "(3) XPU Graph may increase device memory usage, "
            "potentially causing OOM errors or leaving less memory "
            "for the KV cache and reducing performance."
        )

评论区精华

Review 过程简短，rogerxfeng8 表示“The warning message generally LGTM”并批准，jikunshang 无评论直接批准。无实质性讨论。

• 暂无高价值评论线程

风险与影响

• 风险：无实质风险。变更仅为新增日志输出，不影响任何业务逻辑、配置解析或执行路径。唯一的潜在风险是日志可能被用户忽略或产生少量日志噪音，但由于使用 warning_once，影响可控。
• 影响：仅影响 XPU 平台用户在启用 XPU Graph 时的启动日志输出。功能无变化，性能无影响。团队维护成本极低。
• 风险标记：暂无

关联脉络

• 暂无明显关联 PR