如何使用ldap3模块从本地AD中查询指定用户？

数据老陈

2026-10-6

排查步骤及修改方案

第一步：先定位是绑定失败还是搜索失败

你代码中的print(results)输出False，首先要区分是conn.bind()返回False走了else分支，还是绑定成功后conn.search()返回False。你可以先在绑定分支里加一行打印确认：

if conn.bind():
    print("绑定成功")
    # 原有搜索代码
else:
    print("绑定失败")
    print(conn.result) # 打印绑定错误详情

绑定失败的修复方案

绝大多数企业AD默认关闭匿名查询权限，你现在的代码用的是匿名绑定，大概率是被AD拒绝了。修改绑定代码，传入合法的域账号密码即可：

from ldap3 import Server, Connection, ALL, SUBTREE

srv = Server('company.com', get_info=ALL)
# 域账号格式支持两种：「用户名@域后缀」或者「域\用户名」
conn = Connection(srv, user='your_ad_account@company.com', password='your_account_password')

绑定成功但搜索返回False的修复方案

按优先级排查以下问题：

搜索基准DN错误：确认你填的ou=Users,ou=Office1,ou=HQ,dc=company,dc=com路径在AD中真实存在，测试时可以先把搜索基准改到根域，同时指定搜索范围为全子树：

user = 'John'
results = conn.search(
    search_base='dc=company,dc=com',
    search_filter=f"(&(objectClass=person)(givenName={user}))",
    search_scope=SUBTREE,
    attributes=['mail', 'sn', 'givenName']
)

匹配字段错误：如果你要搜索的是用户的登录名，AD中对应的字段是sAMAccountName而非givenName，可以把过滤器里的givenName替换为sAMAccountName测试。
特殊字符未转义：如果用户名包含*、(、)这类特殊字符，直接字符串拼接会导致过滤器语法错误，建议用ldap3自带的过滤器构造方法或者先对用户名做转义处理。