Poetry执行install/update/lock时陷入无限循环问题求助

1. 清理Poetry缓存 #

缓存损坏或堆积可能导致进程卡住，执行命令清理所有PyPI缓存：

poetry cache clear --all pypi

清理完成后重新尝试目标命令。

2. 切换PyPI镜像源 #

即使网络看似正常，官方源的隐性连接问题也可能引发卡顿，可切换到国内稳定镜像，比如阿里云：
在项目的pyproject.toml中添加源配置：

[[tool.poetry.source]]
name = "aliyun"
url = "https://mirrors.aliyun.com/pypi/simple/"
default = true

也可临时指定源执行命令：

poetry install --source aliyun

3. 禁用并行安装 #

Poetry 1.2.x的并行安装可能存在兼容性问题，尝试禁用并行：

poetry install --no-parallel

若需要永久禁用，修改全局配置：

poetry config installer.parallel false

4. 缩小依赖版本解析范围 #

过宽的版本范围会让Poetry遍历大量版本组合，导致解析卡住。在pyproject.toml中给对应包指定更精确的版本，比如将requests>=2.0改为requests>=2.28.0,<2.30.0，降低解析压力。

5. 重新生成兼容的.lock文件 #

因版本限制无法升级Poetry，可删除现有poetry.lock，用1.2.1版本重新生成适配流水线的文件：

rm poetry.lock
poetry lock --no-update

生成后验证流水线能否正常读取该文件。

6. 排查单个依赖问题 #

通过-vvv输出定位卡住的具体包，单独安装测试：

poetry add <卡住的包名> -vvv

如果单独安装也卡顿，说明该包的源存在问题，尝试更换源或指定特定版本安装。

内容的提问来源于stack exchange，提问作者A-fandino