# PR #7320 完整报告

- 仓库：`PaddlePaddle/FastDeploy`
- 标题：[XPU][CI] fix xpu ci bug
- 合并时间：2026-04-11 00:26
- 原文链接：http://prhub.com.cn/PaddlePaddle/FastDeploy/pull/7320

---

# 执行摘要

- 一句话：修复 XPU CI 依赖版本问题，将 XTDK 从 latest 固定为 3.6.2.1。
- 推荐动作：该 PR 变更简单直接，适合快速了解 CI 版本管理最佳实践。值得关注的点是：在 CI 脚本中避免使用 'latest' 等不确定版本是基础设施维护的常见模式。

# 功能与动机

根据 review 评论，将 'latest' 改为固定版本号是 CI 最佳实践，可提高构建的稳定性和可复现性。Copilot 指出 'latest' 版本可能导致 CI 构建不可复现，固定版本号可提高 CI 稳定性。PR 描述未填写具体失败日志，但变更目的明确为修复 XPU CI bug。

# 实现拆解

修改 custom_ops/xpu_ops/download_dependencies.sh 脚本：在 develop 分支模式下（非 stable 模式），将 version_xtdk 变量从 'latest' 改为 '3.6.2.1'。该脚本负责下载 XPU 自定义算子所需的依赖库，版本固定确保每次 CI 构建使用相同的依赖版本。

关键文件：
- `custom_ops/xpu_ops/download_dependencies.sh`（模块 XPU 自定义算子）: 唯一修改的文件，控制 XPU 自定义算子依赖下载的版本选择，直接影响 CI 构建的依赖版本。

关键符号：未识别


# 评论区精华

review 中主要讨论 PR 描述不完整问题。Copilot 评论指出 PR 描述未填写 Motivation/Modifications 等关键章节，无法判断变更原因和验证步骤，建议补充失败日志、版本选择依据和验证步骤。fastdeploy-bot 也指出 PR 描述过于简略，但认可代码变更合理，将 'latest' 改为固定版本是 CI 最佳实践。

- PR 描述完整性 (documentation): 认可代码变更合理，但建议补充失败日志、版本选择依据和验证步骤。

# 风险与影响

- 风险：风险较低：1) 回归风险：仅修改版本号，不涉及功能逻辑，但需确保 3.6.2.1 版本与现有代码兼容；2) 兼容性风险：如果其他组件依赖特定 XTDK 版本，版本变更可能引入不兼容，但 review 中未提及；3) 测试覆盖：缺少相关测试验证新版本是否正常工作。
- 影响：影响范围有限：1) 对用户：无直接影响，仅影响 CI 构建过程；2) 对系统：提升 CI 构建的稳定性和可复现性，避免因 'latest' 版本变动导致的构建失败；3) 对团队：简化 CI 问题排查，固定版本后更容易复现和调试构建问题。
- 风险标记：缺少测试覆盖

# 关联脉络

- PR #7315 [CI] Ensure container cleanup after job to avoid resource leakage: 同为 CI 相关优化，关注资源管理和稳定性。
- PR #7283 [CI] Add no_proxy configuration for docker execution: 同为 CI 配置优化，提升网络稳定性。
- PR #7268 [CI] Set high-risk OOM tests for sequential execution: 同为 CI 稳定性改进，通过配置调整避免问题。