PyPi上传包时twine提示METADATA缺失但文件实际存在

核心问题分析 #

你遇到的矛盾点在于：本地构建的wheel文件解压后明明存在METADATA，但PyPI上传时却提示找不到该文件。结合错误信息里的路径差异（文件名是***_Ashenguard-3.2.0，检测路径是***_ashenguard-3.2.0.dist-info），大概率是大小写不匹配或工具版本、打包配置问题导致的。

具体解决方案 #

1. 统一包名大小写（优先级最高） #

PyPI要求包名必须全小写，而你的wheel文件名包含大写字母Ashenguard，但检测路径是全小写的ashenguard。在大小写敏感的文件系统（PyPI服务器基于Linux）上，这会直接导致路径匹配失败。

• 修改pyproject.toml的project.name字段为全小写：

  [project]
  name = "***_ashenguard"
  

• 清理旧构建产物：删除dist/、build/、*.egg-info/目录
• 重新执行py -m build和twine upload dist/*

2. 更新构建工具版本 #

旧版的build或twine可能存在元数据打包的bug，导致wheel内部路径异常：

• 升级工具到最新版：

  pip install --upgrade build twine
  

• 清理旧产物后重新构建上传

3. 校验wheel内部结构 #

用官方工具解压wheel，避免系统zip工具的兼容性问题：

wheel unpack ***_Ashenguard-3.2.0-py3-none-any.whl

检查解压后的目录，确保***_ashenguard-3.2.0.dist-info目录下直接存在METADATA文件，无额外嵌套。如果结构异常，检查pyproject.toml中的tool.setuptools.packages配置，确认包的打包路径正确。

4. 清理缓存重新构建 #

删除dist/目录下的所有旧文件，重新执行py -m build，确保生成的是全新的wheel文件。如果之前上传过部分文件，可添加--skip-existing参数跳过已上传文件：

twine upload --skip-existing dist/*

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