生产环境必须用ldap.dialurl而非ldap.dial。因前者自动识别ldaps://、ldap://、ldapi://协议并正确配置tls或unix域套接字，后者仅支持裸tcp，手动配tls易漏starttls或证书校验，导致明文传输或错误码49认证失败。
生产环境必须用 ldap.DialURL，不用 ldap.Dial。后者只支持裸 TCP，手动配 TLS 极易漏掉 StartTLS 或证书校验，导致连接看似成功、实则明文传输。
为什么 ldap.DialURL 是唯一可靠选择
它能自动识别协议前缀并匹配行为：ldaps:// 走 TLS 握手，ldap:// 自动调用 StartTLS，ldapi:/// 直连 Unix 域套接字。而 ldap.Dial("tcp", "host:389") 后直接 Bind，在 AD 环境大概率报 LDAP Result Code 49 "Invalid Credentials"——其实根本不是密码错，是 TLS 没协商成功。
- 测试自签名 LDAPS 时，用
ldap.DialURL("ldaps://host:636", ldap.WithTLSConfig(&tls.Config{InsecureSkipVerify: true}))，别退回到ldap.Dial+ 手动 TLS - 本地开发 slapd 用
ldap.DialURL("ldapi:///var/run/slapd/ldapi")，这是ldap.Dial完全不支持的场景 -
ldap.DialURL内部已设默认超时（约 30 秒），而ldap.Dial默认无限等待，网络抖动时卡死无提示
DN 字符串绝不能硬编码或拼接
AD 的 DN 常是 CN=John Doe,OU=Users,DC=corp,DC=example,DC=com，OpenLDAP 更倾向 uid=jdoe,ou=people,dc=example,dc=com。两者格式差异大，硬编码 fmt.Sprintf("uid=%s,ou=people,dc=foo,dc=com", username) 在切换目录服务时必然崩。
- 先用管理员账号搜索用户，从
sr.Entries[0].DN安全提取真实 DN，再用于Bind - 搜索条件优先用
mail或 AD 的sAMAccountName，别依赖uid=——很多 AD 环境根本没填 uid 属性 - 用户名含
@、\、(等字符时，filter 必须过ldap.EscapeFilter()，否则"(uid=" + username + ")"会语法错误
连接池比全局单例 *ldap.Conn 更靠谱
微服务高并发下，全局单例连接会被多个 goroutine 争抢，容易触发 ldap.Error: LDAP Result Code 2 "Protocol Error"。连接池能复用连接、隔离状态、自动重连。
- 用
github.com/jackc/pgx/v5/pgxpool那种思路不行——LDAP 库没内置连接池，得自己封装：维护一个sync.Pool存*ldap.Conn，每次取用前检查conn.IsClosing()和conn.Bound() - 每次操作完必须
defer conn.Close()，但注意：这不是断开物理连接，只是归还到池；真正的关闭由池的清理函数控制 - 连接池初始化时，用
ldap.DialURL建立若干空闲连接并预绑定管理员凭据，避免首次请求时才建连+认证的延迟
错误码 49 不代表密码错，日志里别打密码
conn.Bind(userDN, password) 失败返回 *ldap.Error，err.Code == 49 九成是 DN 格式不对、TLS 没启用、或 AD 要求 pre-Windows 2000 兼容格式（如 DOMAIN\username）。直接返回该错误给前端，等于泄露用户存在性。
- 绑定失败统一返回模糊提示：“认证失败”，不区分“用户不存在”和“密码错误”
- 密码字段进函数后立刻转成
[]byte，绑定完成后用bytes.Fill清零，再加runtime.KeepAlive防止 GC 提前回收 - 调试阶段可在
conn.Bind前加日志打印userDN，肉眼核对大小写、空格、逗号转义（比如 CN=John\, Doe）
真正麻烦的是 DN 格式和 TLS 配置的组合爆炸：AD 要 ldaps:// + 全链证书校验，OpenLDAP 测试环境要 ldap:// + StartTLS + 跳过校验，slapd 本地要用 ldapi://。这些不能靠 if-else 硬切，得把协议、端口、TLS 选项、BaseDN、搜索属性都做成配置项，运行时加载——否则换环境就得改代码、重新编译。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
