ipam/PYTHON_3_10_COMPATIBILITY.md

Python 3.10 兼容性说明

概述

本分支 (python3.10) 专门针对 Python 3.10 环境优化，确保所有代码和依赖都能在 Python 3.10 下正常运行。

兼容性调整

已验证的兼容特性

✅ 所有依赖包版本均支持 Python 3.10 ✅ 无 Python 3.11 特有语法（如 tomllib、asyncio.TaskGroup、typing.Self 等） ✅ 类型注解完全兼容 Python 3.10 ✅ match 关键字未用作 Python 3.10 的模式匹配语句（仅用作 re.match() 的变量名）

重要依赖说明

pysnmp 兼容问题解决

问题：pysnmp==7.1.15 存在以下兼容性问题：

• 使用已废弃的 asyncio.coroutine 装饰器（Python 3.11 中已移除）
• 与 Python 3.10+ 的 asyncio 不兼容

解决方案： 使用社区维护的分支 pysnmp-lextudio==5.0.31

• 完全向后兼容原有 pysnmp API
• 支持 Python 3.6+
• 积极维护，修复了 asyncio 兼容性问题
• 导入方式完全不变

# 无需修改代码，导入方式保持一致
from pysnmp.hlapi.asyncio import bulkCmd, getCmd, nextCmd

pyasn1 版本冲突解决

问题：pyasn1>=0.5.0 移除了 pyasn1.compat.octets 模块，导致 pysnmp 导入失败。 同时 python-jose==3.5.0 强制要求 pyasn1>=0.5.0，形成版本冲突。

解决方案：

• pyasn1==0.4.8 - 锁定到包含 compat.octets 的版本
• pyasn1-modules==0.2.8 - 配套版本
• python-jose[cryptography]==3.3.0 - 兼容 pyasn1 0.4.8 的版本

依赖版本要求

• pysnmp-lextudio==5.0.31 - SNMP 协议兼容替代
• typing-extensions>=4.5.0 - 提供额外的类型支持
• 所有核心依赖（FastAPI、SQLAlchemy、Pydantic 等）均已验证兼容

已知的 Python 3.11+ 特性未使用

项目中未使用以下 Python 3.11+ 特有的功能：

• tomllib 标准库（如有需要可使用 tomli 第三方库）
• asyncio.TaskGroup
• typing.Self
• ExceptionGroup / except*
• StrEnum / IntEnum 的新特性

安装说明

cd backend
pip install -r requirements.txt

升级提示

如果未来需要升级到 Python 3.11+，可以：

1. 使用 tomllib 替代可能的 TOML 解析需求
2. 考虑使用 asyncio.TaskGroup 改进异步代码结构
3. 使用 typing.Self 简化类型注解

验证

可以使用以下命令验证 Python 版本兼容性：

python --version  # 应为 3.10.x 或 3.11.x
python -c "import sys; assert sys.version_info >= (3, 10), 'Python 3.10+ required'"

# 验证 pysnmp 导入
python -c "from pysnmp.hlapi.asyncio import bulkCmd, getCmd, nextCmd; print('pysnmp OK')"