解决 Poetry 安装错误：SecretStorage required

本文旨在帮助读者解决在使用 Poetry 安装依赖时遇到的 SecretStorage required 错误。该错误通常与 python-keyring 的配置有关，python-keyring 尝试使用 SecretStorage 作为密钥存储后端，但配置不正确导致安装失败。本文将提供详细的解决方案，通过修改 python-keyring 的配置文件，使 Poetry 能够正常安装依赖。

当使用 Poetry 安装依赖时，可能会遇到类似以下的错误信息：

Cannot install pyasn1.   RuntimeError   SecretStorage required

或者在尝试添加 SecretStorage 依赖时，仍然出现相同的错误。这通常表明 python-keyring 库配置不正确，导致 Poetry 无法正常工作。

问题原因

问题的根本原因是 python-keyring 库尝试使用 SecretStorage 作为密钥存储后端，但由于某种原因（例如，SecretStorage 未正确安装或配置），导致 Poetry 无法找到或使用它。

解决方案

解决此问题的关键是修改 python-keyring 的配置文件，将其配置为使用一个可用的密钥存储后端。最简单的方法是将其配置为使用 NULL 后端，这意味着不使用任何密钥存储。

步骤 1：找到配置文件

python-keyring 的配置文件通常位于 ~/.config/python-keyring/keyringer.cfg。如果该文件不存在，则需要创建它。

步骤 2：修改配置文件

Adobe Firefly

Adobe最新推出的ai图像生成和编辑工具

32

查看详情

使用文本编辑器打开 keyringer.cfg 文件，并找到 default-keyring 行。如果该行不存在，则将其添加到文件的 [backend] 部分。

将 default-keyring 的值修改为 keyring.backends.null.Keyring，如下所示：

[backend] default-keyring=keyring.backends.null.Keyring

步骤 3：保存文件

保存对 keyringer.cfg 文件的更改。

步骤 4：重新运行 Poetry

现在，重新运行 poetry install 命令。如果问题确实是由于 python-keyring 配置不正确引起的，那么 Poetry 应该能够正常安装依赖了。

注意事项

• 如果修改配置文件后问题仍然存在，请确保 ~/.config/python-keyring/keyringer.cfg 路径正确，并且文件内容已正确保存。
• 如果需要使用密钥存储，可以尝试配置 python-keyring 使用其他的后端，例如 keyring.backends.file.PlaintextKeyring (不安全，明文存储) 或 keyring.backends.OSXKeyChain.Keyring (Macos平台)。请根据自己的需求和环境选择合适的后端。
• 确保 Poetry 和 python-keyring 都是最新版本，以避免已知的问题。可以使用 pip install –upgrade poetry keyring 命令更新它们。

总结

通过修改 python-keyring 的配置文件，可以将密钥存储后端更改为 null 或其他可用后端，从而解决 Poetry 安装过程中遇到的 SecretStorage required 错误。在解决问题后，Poetry 应该能够正常安装依赖，使您能够继续开发工作。请记住，选择合适的密钥存储后端取决于您的安全需求和操作系统。