Spring Boot中如何用LdapTemplate从LDAP获取全量用户详情？

问题原因 #

Active Directory默认对LDAP查询设置了页面大小限制（通常默认值为1000或2500条），你的代码使用的ldapTemplate.search()普通查询方法不会自动处理分页逻辑，因此只能获取到第一页的记录。

代码修改方案 #

使用Spring LDAP提供的PagedResultsDirContextProcessor实现分页查询，循环获取所有页面的记录，直到没有更多数据为止。修改后的代码如下：

public List<LdapUserDetails> findLdapUsers(String filter) {
    List<LdapUserDetails> allUsers = new ArrayList<>();
    int pageSize = 1000; // 每页记录数，建议不超过AD设置的maxPageSize值
    byte[] pageCookie = null;
    int retryCount = 0;
    boolean hasMoreData = true;

    while (hasMoreData && retryCount <= MAX_RETRY) {
        try {
            // 初始化分页处理器，传入每页大小和上一页的cookie
            PagedResultsDirContextProcessor pageProcessor = new PagedResultsDirContextProcessor(pageSize, pageCookie);
            // 执行分页查询，传入处理器
            List<LdapUserDetails> currentPageUsers = ldapTemplate.search(BASE_EU, filter, pageProcessor, new PersonAttributesMapper());
            
            allUsers.addAll(currentPageUsers);
            // 获取下一页的cookie，cookie为null表示没有更多数据
            pageCookie = pageProcessor.getCookie();
            hasMoreData = pageCookie != null;
            
            System.out.println("累计获取记录数: " + allUsers.size());
            retryCount = 0; // 成功获取一页，重置重试计数
        } catch (CommunicationException e) {
            System.out.println("通信异常，尝试重试: " + e.getMessage());
            retryCount++;
            if (retryCount > MAX_RETRY) {
                throw new RuntimeException("重试次数超出上限，无法继续获取数据", e);
            }
            // 重试前添加短暂延迟，避免频繁请求
            try {
                Thread.sleep(1000);
            } catch (InterruptedException ie) {
                Thread.currentThread().interrupt();
            }
        } catch (Exception e) {
            System.out.println("查询失败: " + e.getMessage());
            throw new RuntimeException("LDAP查询异常", e);
        }
    }

    return allUsers;
}

关键配置与注意事项 #

• 页面大小设置：pageSize不要超过AD服务器的maxPageSize配置（默认是1000，管理员可修改至10000）。你可以通过LDAP查询根节点的maxPageSize属性获取当前限制值。
• AD分页支持：确保AD服务器开启了LDAPv3分页控制（默认是开启的，若被管理员禁用需联系开启）。
• 重试逻辑优化：仅针对通信异常进行重试，其他异常直接抛出，避免无效循环。
• 避免数据覆盖：原代码中每次查询都会覆盖结果列表，修改后改为将每页数据追加到总列表中。

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