使用twine上传wheel至PyPI时遇Metadata-Version 2.5无效错误排查

错误信息 #

$ twine --version
twine version 6.2.0 (keyring: 25.7.0, packaging: 26.2, requests: 2.34.0, requests-toolbelt: 1.0.0, urllib3: 2.7.0, id: 1.6.1)
$ twine upload meowpkg-0.1-py2.py3-none-any.whl
Uploading distributions to https://upload.pypi.org/legacy/
ERROR    InvalidDistribution: Invalid distribution metadata: '2.5' is not a valid metadata version

Wheel包结构 #

meowpkg-0.1-py2.py3-none-any.whl
└── meowpkg-0.1.dist-info
    ├── METADATA
    ├── RECORD
    └── WHEEL

关键文件内容 #

METADATA #

Metadata-Version: 2.5
Name: meowpkg
Version: 0.1
Import-Name: 

WHEEL #

Wheel-Version: 1.0
Generator: whl 0.0.7
Root-Is-Purelib: true
Tag: py2-none-any
Tag: py3-none-any

问题出在Twine当前依赖的packaging库版本（26.2）还未支持Metadata-Version 2.5。Metadata-Version的有效值列表由packaging库维护，2025年9月才生效的2.5版本还没被该版本的packaging纳入允许范围。

解决办法：

• 直接升级packaging库到包含Metadata-Version 2.5支持的版本：

  pip install --upgrade packaging
  

• 或者升级Twine到依赖新版packaging的版本：

  pip install --upgrade twine
  

升级后重新执行twine upload即可正常上传。

内容的提问来源于stack exchange，提问作者wim