自行发布的Python包fastapi-casdoor无法安装,请求排查
排查fastapi-casdoor无法安装的原因
1. setup.cfg配置语法错误
你的setup.cfg中python_requires的写法存在语法问题:
# 错误写法 python_requires =>=3.6
setup.cfg的配置项采用键 = 值的标准格式,这里的=>=是无效符号,会导致工具无法正确解析Python版本要求,需修改为:
# 正确写法 python_requires = >=3.6
2. 确认PyPI分发文件完整性
登录PyPI的包页面,检查是否成功上传了有效的分发文件(如.tar.gz源码包或.whl wheel包)。如果上传过程仅提交了元数据而无实际包文件,就会出现能搜索到包但无法安装的情况。
3. 项目结构与包名不匹配
你的配置指定了package_dir = = src且从src目录查找包,需确保:
src目录下存在与包名对应的Python包目录(包名fastapi-casdoor在Python中等价于fastapi_casdoor,因此目录名应为fastapi_casdoor)- 该目录下必须包含
__init__.py文件(哪怕是空文件),否则setuptools无法识别为可打包的Python包
4. 本地缓存干扰
pip和poetry的本地缓存可能留存了错误的包信息,尝试清理后重试:
清理pip缓存
pip cache purge pip install fastapi-casdoor
清理poetry缓存
poetry cache clear pypi --all poetry add fastapi-casdoor
修复步骤总结
- 修正
setup.cfg中python_requires的语法错误 - 确认src目录下的包结构符合要求
- 使用
python -m build重新生成分发包(确保dist/目录下生成.tar.gz和.whl文件) - 使用
twine upload dist/*重新上传到PyPI - 清理本地缓存后再次尝试安装
内容的提问来源于stack exchange,提问作者winrey
相关产品推荐
相关产品推荐

