ldap连接失败主因是网络或dns问题，需用ping/nslookup验证域名解析，docker中linux须用宿主机真实ip；自签名ldaps需跳过证书校验；错误码49多因dn格式不符ad/openldap规范；search为空多因basedn过窄、filter未转义或权限不足；务必设置连接与操作超时并defer关闭连接。
LDAP连接失败：dial tcp: lookup ldap.example.com: no such host
这不是代码问题，是网络环境没通。Go 的 ldap.Dial 或 ldap.DialURL 完全依赖系统 DNS 解析，不读 /etc/hosts 以外的配置。
- 先用
ping ldap.example.com和nslookup ldap.example.com确认域名可达 - 不行就直接换 IP，比如
"10.1.2.3:389"，避免绕 DNS - Docker 场景下，宿主机 Go 程序连容器内 LDAP 时：
– Mac/Windows 用host.docker.internal
– Linux 必须用宿主机真实 IP，localhost会连到容器自己 - 自签名 LDAPS 证书默认校验失败，调试阶段需显式传
&tls.Config{InsecureSkipVerify: true}，但仅限本地开发
Bind 返回 LDAP Result Code 49 “Invalid Credentials”
错误码 49 九成不是密码错，而是 DN 格式不对。AD 和 OpenLDAP 对绑定 DN 的拼写规范差异大，且错误信息不提示具体哪部分错。
- AD 常见 DN：
CN=John Doe,OU=Users,DC=corp,DC=example,DC=com - OpenLDAP 常见 DN：
uid=jdoe,ou=people,dc=example,dc=com - 别硬编码 DN 字符串；用
fmt.Sprintf拼接前，先用ldapsearch手动查一遍目录结构：ldapsearch -x -H ldap://10.1.2.3:389 -D "cn=admin,dc=example,dc=com" -W -b "dc=example,dc=com" "(objectClass=*)" - 务必在
conn.Bind(dn, password)前加日志打印dn值，肉眼核对空格、大小写、逗号转义（如用户名含\或,）
Search 返回空结果但 Bind 成功
Bind 能过说明网络、账号、密码都 OK，Search 为空只可能是查询条件或权限问题。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
-
BaseDN太窄：想查所有用户，别写ou=dev,dc=example,dc=com，先试dc=example,dc=com -
filter没转义：用户名含@、\、(等特殊字符时，fmt.Sprintf("(uid=%s)", username)会崩，必须用ldap.EscapeFilter(username) - 权限不足：AD/OpenLDAP 默认不返回
userPassword；若启用了密码策略（ppolicy），匿名 bind 或低权限账号可能查不到多数属性——确保BindDN有足够read权限 - scope 设定太严：用
ldap.ScopeWholeSubtree，别用ScopeBaseObject或ScopeSingleLevel
conn.Bind / conn.Search 卡死无报错
gopkg.in/ldap.v3（及 github.com/go-ldap/ldap/v3）默认不设超时，网络抖动或服务端无响应时，调用会一直阻塞，直到 TCP keepalive 触发（往往几分钟后）。
- 必须手动设置连接和操作超时：
– 连接超时：ldap.Dial("tcp", addr)后立即调用conn.SetTimeout(5 * time.Second)
– 更稳妥的做法是用ldap.DialURL+ 自定义net.Dialer控制底层连接超时 - Search 请求也建议加
TimeLimit参数：ldap.NewSearchRequest(..., 10, ...)表示最多等 10 秒 - 生产环境务必包裹
defer conn.Close()，否则连接泄漏会迅速耗尽 fd
真正难调的不是 Bind 或 Search 的逻辑，而是 BaseDN 是否覆盖目标 OU、filter 是否被正确转义、以及超时是否真生效——这三处不验证，日志里永远只看到 “no such host” 或 “invalid credentials”，实际卡在别的地方。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
