32位Windows下PyInstaller打包Keyring程序报错求助

这个问题我之前也碰到过，核心原因是32位打包后的进程无法正确识别或加载WinVault凭据管理器的后端模块，具体细节和解决办法如下：

为什么会出现这个问题？ #

当你直接在32位Python环境中运行代码时，keyring能自动检测并适配32位架构的WinVault后端——毕竟此时Python进程本身是32位，能正常调用对应系统接口。但PyInstaller打包成单文件exe时，可能会遗漏keyring后端的部分依赖，或者打包后的环境破坏了keyring的自动后端检测逻辑，导致它找不到可用的推荐后端，最终 fallback 到了fail.Keyring，触发那个RuntimeError。

解决办法 #

1. 显式指定WinVault后端（最直接有效） #

绕过自动检测逻辑，在代码里手动指定使用WinVault后端，确保程序运行时一定会加载它。修改你的test.py代码：

import keyring
from keyring.backends.Windows import WinVaultKeyring

# 强制设置使用WinVault后端
keyring.set_keyring(WinVaultKeyring())

print(keyring.get_keyring())
keyring.set_password("a","b","c")
print(keyring.get_password("a","b"))

之后重新用PyInstaller打包32位程序：

pyinstaller --onefile test.py

2. 强制PyInstaller包含后端依赖 #

如果显式指定后端还是不行，大概率是PyInstaller没把keyring的后端模块打包进去，可以通过--hidden-import参数强制导入：

pyinstaller --onefile --hidden-import keyring.backends.Windows test.py

或者更彻底一点，创建一个hook文件来收集所有keyring后端模块：
在test.py同目录下新建hook-keyring.py，内容如下：

from PyInstaller.utils.hooks import collect_submodules

hiddenimports = collect_submodules('keyring.backends')

然后打包时指定这个hook目录：

pyinstaller --onefile --additional-hooks-dir=. test.py

3. 检查环境兼容性 #

确保你的32位Python环境和keyring版本匹配，建议升级到最新稳定版的keyring：

pip install --upgrade keyring

同时确认你的32位Python是完整安装的，没有缺失Windows相关的系统依赖库。

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