# PR #35530 完整报告

- 仓库：`vllm-project/vllm`
- 标题：[Misc] Fix stale doc URL and docstring module path
- 合并时间：2026-06-21 07:57
- 原文链接：http://prhub.com.cn/vllm-project/vllm/pull/35530

---

# 执行摘要

- 一句话：修复两处过时文档引用
- 推荐动作：PR 改动简单明确，无功能影响，值得合并以改善文档准确性。不建议精读。

# 功能与动机

PR 提交者发现两个文档引用已过时：VLLM_PORT 错误信息链接到 en/stable/serving/env_vars.html 返回 404，应指向 en/latest/configuration/env_vars.html；tool_parsers/__init__.py 的 docstring 示例中模块路径写的是 vllm.tool_parsers.kimi_k2_parser，但实际模块名为 kimi_k2_tool_parser。

# 实现拆解

1. 在 vllm/envs.py 中，将 get_vllm_port() 函数内 ValueError 的提示 URL 从 `https://docs.vllm.ai/en/stable/serving/env_vars.html` 更新为 `https://docs.vllm.ai/en/latest/configuration/env_vars.html`，避免用户跳转到 404 页面。
2. 在 vllm/tool_parsers/__init__.py 中，将 docstring 示例里的 `module_path="vllm.tool_parsers.kimi_k2_parser"` 修正为 `module_path="vllm.tool_parsers.kimi_k2_tool_parser"`，使示例与实际模块名称一致。

关键文件：
- `vllm/envs.py`（模块 环境配置；类别 source；类型 core-logic）: 修复 VLLM_PORT 错误信息中的文档 URL，避免用户访问 404 页面。
- `vllm/tool_parsers/__init__.py`（模块 工具解析器；类别 source；类型 docstring）: 修正 docstring 示例中的模块路径，与实际模块名称一致。

关键符号：get_vllm_port

## 关键源码片段

### `vllm/envs.py`

修复 VLLM_PORT 错误信息中的文档 URL，避免用户访问 404 页面。

```python
def get_vllm_port() -> int | None:
    """Get the port from VLLM_PORT environment variable."""
    if "VLLM_PORT" not in os.environ:
        return None
    port = os.getenv("VLLM_PORT", "0")
    try:
        return int(port)
    except ValueError as err:
        from urllib3.util import parse_url
        parsed = parse_url(port)
        if parsed.scheme:
            raise ValueError(
                f"VLLM_PORT '{port}' appears to be a URI. "
                "This may be caused by a Kubernetes service discovery issue,"
                "check the warning in: https://docs.vllm.ai/en/latest/configuration/env_vars.html"
                # 原 URL 为 en/stable/serving/env_vars.html（返回 404），
                # 已更新为 en/latest/configuration/env_vars.html
            ) from None
        raise ValueError(f"VLLM_PORT '{port}' must be a valid integer") from err

```

# 评论区精华

无 review 讨论。gemini-code-assist[bot] 的自动评论确认了改动的准确性，sfeng33 直接批准并回复 "Thanks"。

- 暂无高价值评论线程

# 风险与影响

- 风险：无技术风险。两个改动均为纯文档 / 字符串更正，不涉及逻辑变更。
- 影响：影响范围极小。仅影响：
 1) VLLM_PORT 设置错误时用户的错误提示链接（从 404 变为有效页面）；
 2) tool_parsers 模块文档字符串中示例代码的准确性。对系统行为、性能、安全性等均无影响。
 - 风险标记：暂无

# 关联脉络

- 暂无明显关联 PR