执行摘要

• 一句话：为 mini_lb 功能添加 Rust 依赖缺失时的降级处理，避免导入失败。
• 推荐动作：该 PR 变更简单直接，适合快速浏览以了解环境兼容性处理模式。值得关注的设计决策是使用 try-except 进行可选依赖导入，这是一种常见的 Python 模块化技术。

功能与动机

根据 PR body 描述“sometimes our env have no rust....”，动机是在某些环境（推测为测试或特定部署环境）中缺少 Rust 依赖，导致 sglang_router_rs 模块不可用，进而使 mini_lb 功能失败。需要添加降级处理以避免导入异常。

实现拆解

1. 修改导入逻辑：在 sgl-model-gateway/bindings/python/src/sglang_router/router_args.py 中，将直接导入 get_available_tool_call_parsers 的语句包装在 try-except 块中。
2. 添加降级实现：当捕获到 ModuleNotFoundError 时，记录警告日志并定义一个返回空列表的本地函数作为替代。
3. 日志增强：在第二个 commit 中增加了更明确的警告消息，提示模块不可用时的行为变化。
4. 无测试或配置配套改动：本次变更仅涉及源码级别的兼容性处理，未添加或修改测试、配置或部署文件。

关键文件：

• sgl-model-gateway/bindings/python/src/sglang_router/router_args.py（模块 模型网关；类别 source；类型 data-contract；符号 get_available_tool_call_parsers）: 这是唯一被修改的文件，包含了导入降级逻辑的核心变更，直接影响 mini_lb 功能的启动健壮性。

关键符号：get_available_tool_call_parsers

关键源码片段

sgl-model-gateway/bindings/python/src/sglang_router/router_args.py

这是唯一被修改的文件，包含了导入降级逻辑的核心变更，直接影响 mini_lb 功能的启动健壮性。

import argparse
import dataclasses
import logging
import os
from typing import Dict, List, Optional
​
# 关键变更：使用 try-except 处理可选 Rust 依赖导入
try:
    from sglang_router.sglang_router_rs import get_available_tool_call_parsers
except ModuleNotFoundError:
    # 当 sglang_router_rs 模块不可用时（如缺少 Rust 环境），记录警告并提供降级实现
    logging.warning(
        "sglang_router_rs is not available, get_available_tool_call_parsers will return empty list"
    )
​
    # 降级函数：返回空列表，确保调用方不会因导入失败而崩溃
    def get_available_tool_call_parsers() -> List[str]:
        return []
​
​
logger = logging.getLogger(__name__)
​
​
@dataclasses.dataclass
class RouterArgs:
    # Worker configuration
    worker_urls: List[str] = dataclasses.field(default_factory=list)
    host: str = "0.0.0.0"
    port: int = 30000
​
    # PD-specific configuration
    mini_lb: bool = False # 该配置项受本次变更影响，确保在依赖缺失时仍能正常初始化
    test_external_dp_routing: bool = False
    pd_disaggregation: bool = False # Enable PD disaggregated mode
    prefill_urls: List[tuple] = dataclasses.field(
        default_factory=list
    ) # List of (url, bootstrap_port)
    decode_urls: List[str] = dataclasses.field(default_factory=list)
​
    # Routing policy
    # ... 其余代码保持不变

评论区精华

Reviewer ShangmingCai 在批准时提出建议：“Looks good if it is only for testing, but better add a warning msg?”，作者在第二个 commit 中采纳了该建议，增加了警告日志。没有其他争议或未解决的疑虑。

• 是否添加警告日志 (design): 作者在第二个 commit 中采纳建议，增加了明确的警告日志。

风险与影响

• 风险：低风险。变更仅影响导入失败时的降级路径，核心功能逻辑未变。风险点包括：1) 警告日志可能在生产环境中产生噪音，但仅在依赖缺失时触发；2) 降级函数返回空列表可能影响依赖 get_available_tool_call_parsers 返回值的上游逻辑，但根据上下文推测该函数用于工具调用解析器列表，返回空列表可能表示无可用解析器，属于合理降级。
• 影响：影响范围有限。主要影响使用 mini_lb 功能且环境缺少 Rust 依赖的用户（如测试环境），确保服务不会因导入失败而崩溃。对正常环境无影响。系统层面提升了健壮性，团队需注意依赖环境的配置一致性。
• 风险标记：依赖缺失降级

关联脉络

• 暂无明显关联 PR