LDAP绑定失败主因是URI、端口或DN格式错误，而非密码错误；需正确指定协议前缀、校验DN结构、避免证书校验问题，使用ldap_simple_bind_s同步认证并配对调用ldap_unbind清理资源。
LDAP绑定失败：常见错误是ldap_simple_bind_s返回LDAP_INVALID_CREDENTIALS或LDAP_SERVER_DOWN
绝大多数连接认证失败不是密码错，而是 URI、端口或 DN 格式不对。OpenLDAP 客户端默认不校验服务器证书，但若服务端强制 LDAPS（端口 636）且证书不可信，ldap_initialize 可能静默失败，实际调用 ldap_simple_bind_s 时才报 LDAP_SERVER_DOWN。
- 确认服务地址：用
ldap://host:389（明文）或ldaps://host:636（加密），不要漏掉协议前缀 - 检查 DN 格式：普通用户通常是
"uid=username,ou=people,dc=example,dc=com"，不是邮箱或登录名；管理员 DN 一般为"cn=admin,dc=example,dc=com" - 若用 LDAPS，提前调用
ldap_set_option(NULL, LDAP_OPT_X_TLS_REQUIRE_CERT, LDAP_OPT_X_TLS_NEVER)避免证书校验失败（仅测试环境）
用ldap_simple_bind_s做同步认证，别用ldap_bind
ldap_bind 是异步接口，返回后不表示认证完成，需额外轮询消息 ID；而 ldap_simple_bind_s 是阻塞调用，返回即知结果，适合登录鉴权这类短时操作。
- 传入的密码必须是 C 风格字符串（
const char*），不能是std::string::c_str()后未确保生命周期——临时std::string对象析构会导致悬垂指针 - DN 和密码都为
NULL时触发匿名绑定，多数 OpenLDAP 默认禁止，会返回LDAP_INSUFFICIENT_ACCESS - 成功时返回
LDAP_SUCCESS，其他值都要当错误处理，不要只判断非零
记得清理资源：ldap_unbind不是可选项
每次 ldap_initialize 或 ldap_open 后必须配对调用 ldap_unbind，否则连接句柄泄漏，进程跑久了会耗尽文件描述符，表现为后续 ldap_initialize 返回 NULL。
-
ldap_unbind接收的是LDAP*指针，不是整数句柄；传入NULL会段错误 - 如果
ldap_simple_bind_s失败，仍要调用ldap_unbind清理已建立的连接上下文 - 建议用 RAII 封装：构造时
ldap_initialize，析构时ldap_unbind，避免裸指针管理
OpenLDAP 库链接和头文件路径容易漏掉-lldap -llber
编译时只加 -lldap 不够，libldap 依赖 liblber（LDAP Basic Encoding Rules 库），漏掉会报类似 undefined reference to ber_memfree 的链接错误。
立即学习“C++免费学习笔记（深入）”；
- g++ 命令末尾必须同时写
-lldap -llber，顺序不能颠倒 - 头文件只需
#include <ldap.h></ldap.h>，但编译前要确保ldap.h在头搜索路径中（如 Ubuntu 装libsasl2-dev和libldap2-dev） - 运行时报
libldap.so.2: cannot open shared object file，说明没装运行时库，不是开发包——CentOS 用yum install openldap，Ubuntu 用apt install libldap-2.4-2
真正麻烦的是 DN 构造逻辑：不同 LDAP 目录结构差异大，硬编码 OU/DC 层级极易出错，得从配置或服务发现里读，而不是写死在代码里。
