RuntimeError: no running event loop 是因 bonsai.AsyncLDAPConnection 要求当前线程存在运行中的 asyncio 事件循环，而默认 Python 解释器启动时未创建；必须用 asyncio.run() 启动主协程，或在 FastAPI 等异步框架的 async def 路由中执行，不可在普通函数或交互式终端裸写 await。
bonsai.AsyncLDAPConnection 连接后立即报 RuntimeError: no running event loop
这是最常卡住的第一步：bonsai 的异步模式依赖当前线程存在运行中的 event loop，但默认 Python 解释器启动时没有。直接调用 await conn.bind() 会触发该错误，不是代码写错了，而是没在 async 上下文里跑。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 必须用
asyncio.run()启动主协程，不能在普通函数里裸写await - 若集成到 FastAPI/Starlette 等框架中，确保认证逻辑在
async def路由函数内执行，而非同步中间件 - 避免在 Jupyter 或交互式终端里测试——某些环境 event loop 管理不一致，优先用 .py 文件 +
python script.py验证
bind() 失败时只抛 bonsai.LDAPError，无法区分账号不存在和密码错误
LDAP 协议本身不强制返回细粒度错误码，OpenLDAP 和 Active Directory 对 bind 失败的响应也不同。bonsai 统一抛出 bonsai.LDAPError，exception.args 里可能含原始 LDAP 错误码（如 49），但不可靠。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 不要依赖异常消息字符串做业务判断（比如匹配
"invalid credentials"），AD 可能返回中文或本地化文本 - 更稳妥的做法是：先用匿名或服务账号执行一次
search()查用户 DN 是否存在，再对确认存在的 DN 执行 bind；两次操作都走异步 - 若仅需“账号密码是否正确”，且可接受轻微延迟，直接 bind 并捕获异常即可——业务层只需知道“校验失败”，无需深究原因
使用 pool_size 和 referrals 参数影响连接复用与重定向行为
bonsai.AsyncLDAPConnection 默认不启用连接池，每次 bind() 都新建 TCP 连接，高频认证下开销明显。同时，某些 LDAP 服务器（尤其是 AD 域控）会在 bind 失败时返回 referral，bonsai 默认不跟随，导致看似无响应。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 初始化客户端时显式传参：
bonsai.AIOConnectionPool(url, pool_size=5, referrals=True) -
pool_size建议设为预期并发请求数的 1.5–2 倍，过大反而增加调度负担 -
referrals=True会让 bonsai 自动处理REFERRAL响应，但需确保目标服务器允许匿名 referral 查询，否则可能因权限不足中断流程
证书验证失败：SSL/TLS 握手时报 ssl.SSLCertVerificationError
连接 LDAPS（ldaps://）或 STARTTLS 时，bonsai 默认校验服务器证书。自签名证书、内网 CA 未导入系统信任库、或域名不匹配都会触发此错。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 生产环境务必保留证书校验，通过
tls_cacertfile="/path/to/ca.pem"指定可信 CA 文件 - 测试环境临时绕过：创建
bonsai.TLSSettings(validate=ssl.CERT_NONE)并传给Connection构造函数，但需配合注释警告 - 若用 DNS SRV 记录自动发现服务器，证书主题名必须匹配实际连接的主机名，不能只写域名通配符
