如何使用LDAPsearch测试LDAP连接 排查Spring应用令牌颁发报错问题

首先先安装对应工具包：

• Debian/Ubuntu 系列：sudo apt install ldap-utils
• RHEL/CentOS/Rocky 系列：sudo yum install openldap-clients

基础测试命令 #

对应你给出的配置，直接执行以下命令即可测试连接和认证是否正常：

ldapsearch -x -H ldaps://ldap.sample.com:740 -D "cn=sample-QA,ou=applicationusers,o=company" -w "fakepassword" -b "cn=sample-QA,ou=applicationusers,o=company" dn

参数说明：

• -x：使用简单认证模式，和你Spring配置的认证方式一致
• -H：指定LDAP服务器地址，和你配置的url完全一致
• -D：指定绑定的管理员DN，对应配置里的manager-dn
• -w：指定绑定密码，对应配置里的manager-password
• -b：指定搜索的根节点，这里直接搜索绑定账号本身验证权限

结果判断 #

• 如果正常返回查询到的DN条目，说明LDAP连接、账号密码认证都正常，问题不在基础连接环节，可以排查Spring应用本身的权限配置、XML特殊字符转义、应用运行用户的证书信任列表等。
• 如果报错，可在命令前加LDAPTLS_REQCERT=never跳过SSL证书校验（仅测试用，生产环境建议把LDAP服务证书加入系统信任库），也可以添加-d 1参数开启调试日志，定位具体是网络不通、证书不被信任、账号密码错误哪类问题。

• ldapwhoami：更轻量的命令行工具，仅验证认证是否成功，对应测试命令如下：

  ldapwhoami -x -H ldaps://ldap.sample.com:740 -D "cn=sample-QA,ou=applicationusers,o=company" -w "fakepassword"
  

  正常会返回你绑定的DN字符串，报错则说明连接或认证失败。
• Apache Directory Studio：跨平台的桌面端LDAP管理工具，支持可视化配置连接、执行搜索、查看目录结构，适合复杂问题排查。
• LDAP Admin：Windows平台轻量免安装工具，操作简单，适合快速测试连接。

内容的提问来源于stack exchange，提问作者user3073180