keyring.get_password()读取Windows凭据管理器凭证时抛出NameError

问题背景 #

• 运行环境：Windows系统、Python 3.10
• 使用目的：通过keyring库安全管理pyodbc、sqlalchemy连接数据库所需的密码，避免明文硬编码在代码中
• 前置操作：已参考官方公开issue说明手动配置keyring使用Windows凭据库（WinVault）作为后端，所有报错涉及的依赖包均已完成安装
• 测试代码：

from keyring.backends import Windows
import keyring
keyring.set_keyring(Windows.WinVaultKeyring())
keyring.get_password("Service", "Username")

• 运行抛出的错误信息：

Traceback (most recent call last):
  File ".\Python310\lib\site-packages\keyring\backends\Windows.py", line 109, in _get_password
    res = win32cred.CredRead(
NameError: name 'win32cred' is not defined

During handling of the above exception, another exception occurred:

Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
  File ".\Python310\lib\site-packages\keyring\core.py", line 55, in get_password
    return get_keyring().get_password(service_name, username)
  File ".\Python310\lib\site-packages\keyring\backends\Windows.py", line 99, in get_password
    res = self._get_password(service)
  File ".\Python310lib\site-packages\keyring\backends\Windows.py", line 112, in _get_password
    except pywintypes.error as e:
NameError: name 'pywintypes' is not defined

• 当前环境已安装包及版本：

故障原因 #

该报错和keyring库本身无关，根源是当前环境安装的pywin32==303版本存在已知兼容问题：该版本在部分Python3.10环境下安装时，不会自动执行模块路径注册脚本，导致win32cred、pywintypes等pywin32附属模块虽然已存在于本地安装目录，但不在Python的导入搜索路径中，keyring的Windows后端懒加载这两个模块失败，就会直接抛出NameError。

解决方法 #

按以下优先级操作，每步完成后重启Python解释器再测试：

1. 手动执行pywin32路径注册脚本
   打开命令行切换到当前Python环境的根目录，执行命令：

   python Scripts/pywin32_postinstall.py -install
   

   命令行输出The pywin32 extensions were successfully installed即代表注册完成。
2. 若执行注册脚本后仍报错，直接降级pywin32到无该问题的稳定版本：

   pip install pywin32==302 --force-reinstall
   

3. 功能验证
   先执行密码写入操作：

   keyring.set_password("Service", "Username", "testpwd123")
   

   再调用keyring.get_password("Service", "Username")，能正常返回testpwd123即代表功能正常，后续可直接读取存储的密码拼接pyodbc、SQLAlchemy连接串，无需明文写密码。

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