Pex工具中pip 25.1版本导致的wheel匹配行为变化分析

在Python生态系统中，pex是一个重要的工具，它能够创建可执行的Python环境。近期，pex用户在使用pip 25.1版本时发现了一个关于wheel包匹配行为的变化问题，这可能导致依赖解析结果与预期不符。

问题背景

当用户使用pex 2.36.1版本结合pip 25.1时，发现对于psutil==5.9.8这个包的wheel文件匹配行为与pip 25.0版本存在差异。具体表现为：

1. 在pip 25.0环境下，pex会匹配并包含x86_64和i686架构的manylinux wheel文件
2. 在pip 25.1环境下，pex不再匹配任何架构的manylinux wheel文件

技术细节分析

通过对比测试，我们可以观察到以下现象：

• 在x86_64 Linux系统上，原生pip 25.0和25.1都只会匹配x86_64架构的wheel文件
• pex 2.36.1与pip 25.0组合时，会匹配两种架构的wheel文件
• pex 2.36.1与pip 25.1组合时，两种架构的wheel文件都不匹配

这表明问题可能出在pex对pip的定制补丁与pip 25.1版本的兼容性上。pex通过修改pip._internal.models.wheel.Wheel.supported的行为来实现跨平台支持，但这种修改在pip 25.1中可能产生了意外的交互效果。

影响范围

这个问题主要影响：

1. 需要跨平台支持的pex用户
2. 使用pex lock功能生成跨平台依赖锁文件的场景
3. 依赖包含多架构wheel文件的Python包的用户

解决方案

项目维护者已经在新发布的pex 2.37.0版本中修复了这个问题。建议用户：

1. 暂时避免使用pip 25.1版本
2. 升级到pex 2.37.0或更高版本以获得修复

技术启示

这个问题提醒我们：

1. Python打包工具链中各组件的紧密耦合可能导致微妙的兼容性问题
2. 跨平台支持需要谨慎处理架构相关的wheel文件匹配逻辑
3. 工具链升级时需要进行充分的兼容性测试

对于Python打包和分发系统的开发者来说，理解wheel文件的标签系统和匹配规则至关重要，这有助于诊断和解决类似的兼容性问题。