# PR #34767 完整报告

- 仓库：`sgl-project/sglang`
- 标题：[CPU] Fix native KV hash compilation in Xeon image
- 合并时间：2026-09-10 12:51
- 原文链接：http://prhub.com.cn/sgl-project/sglang/pull/34767

---

## 执行摘要
该 PR 修复了 Xeon CPU Docker 镜像构建失败的问题。通过向 `docker/xeon.Dockerfile` 添加缺失的 `libssl-dev` 依赖，确保了 SGLang 原生 KV 哈希扩展所需的 OpenSSL 头文件可用，从而解决了编译错误。这是一个简单、必要的基础设施修复。

## 功能与动机
PR 的动机非常直接：修复一个阻碍特定 Docker 镜像构建的 bug。正如 PR body 所述：“The xeon image fails when sglang first compiles its native KV hash extension because `openssl/sha.h` is missing.” 问题的根源是构建环境中缺少了编译所需的标准开发库。

## 实现拆解
1. **变更入口**：`docker/xeon.Dockerfile`。这是唯一被修改的文件。
2. **核心变更**：在 `RUN apt-get update && apt-get install ...` 命令的软件包列表中，插入一行 `libssl-dev`。这是一个标准的 Debian/Ubuntu 包，提供了 OpenSSL 的开发头文件和库文件。
3. **影响分析**：此变更确保了使用该 Dockerfile 构建的镜像能够成功编译 SGLang 的原生 KV 哈希扩展。变更不涉及任何源代码逻辑、测试或运行时配置，因此影响范围被严格限定在特定的构建产物（Xeon Docker 镜像）上。

## 评论区精华
无讨论。PR 由 maintainer mingfeima 直接批准并合并，确认了修复的正确性和必要性。

## 风险与影响
* **风险**：极低。添加一个标准的开发依赖包，其版本和兼容性由系统包管理器在 Docker 构建上下文中处理，几乎不会引入运行时风险。
* **影响**：对于依赖 `xeon.Dockerfile` 进行 CPU 推理部署的用户，这是一个关键修复。修复前，他们的部署流程会因编译失败而中断；修复后，构建流程恢复正常。

## 关联脉络
从同仓库近期历史 PR 来看，该修复与基础设施维护（如 PR#37495、PR#38770、PR#38736）属于同一范畴，都是确保开发、测试和部署流水线顺畅运行的必要工作。它不涉及核心算法、性能优化或新功能开发。