执行摘要

本PR新增一个对称内存调试模式，通过环境变量SGLANG_DEBUG_SYMM_MEM=1启用，用于打印NCCL通信操作中未在对称内存池注册张量的堆栈跟踪。该变更主要为调试目的，帮助开发者快速定位内存管理问题，对系统性能影响较小（默认关闭），但提升了问题排查效率。

功能与动机

动机源自调试需求：在分布式训练中，NCCL通信操作使用对称内存池可提升性能，但若张量未正确注册，可能导致问题。本PR旨在提供工具来识别这些未注册张量，引用PR body中表述："Really useful mode to figure out locations of unregistered tensors"，并附示例日志展示从all_reduce操作回溯的完整调用链。

实现拆解

实现围绕四个文件展开：

1. pynccl_allocator.py：核心模块，新增debug_check_symmetric_mempool函数，检查张量是否在内存池中，并打印去重堆栈跟踪。代码逻辑包括：
   • is_tensor_in_symmetric_mempool：遍历内存池块匹配数据指针。
   • 去重机制：基于操作名、张量名和堆栈字符串哈希避免重复日志。
2. parallel_state.py：在all_reduce、reduce_scatter_tensor、all_gather_into_tensor方法中调用调试检查，集成到通信路径。
3. environ.py：定义环境变量SGLANG_DEBUG_SYMM_MEM，默认false。
4. environment_variables.md：文档更新，记录变量用途。

评论区精华

Review中无实质讨论，仅有两位审核者（hlu1和Fridge003）的批准，表明变更被认可且无争议。结论是直接合并，无需修改。

风险与影响

• 技术风险：启用调试模式时，pynccl_allocator.py中的检查逻辑可能引入性能开销（遍历内存池和生成堆栈跟踪）；日志去重基于堆栈哈希，可能漏报不同上下文的相同张量；缺少单元测试，回归风险较高。
• 影响分析：对用户，提供便捷调试工具；对系统，默认无影响，启用时增加rank 0日志输出；对团队，需学习新环境变量使用。

关联脉络

从近期历史PR看，本PR与内存管理和调试相关PR有脉络关联：

• PR 22384（提取内存池配置逻辑）：共享内存管理上下文，可能为后续优化铺垫。
• PR 22306（延迟导入以减少日志噪音）：同属调试改进，减少系统噪音。
• PR 22308（CI测试文件验证）：涉及run-ci标签和测试基础设施，反映团队对CI稳定性的持续关注。
  整体上，本PR是调试工具链的补充，有助于提升分布式系统的可维护性。