使用System.DirectoryServices.AccountManagement连接LDAP服务器抛NullReferenceException

你遇到的空引用异常是因为PrincipalContext的ContextType.Domain类型不适合连接这个非Active Directory的LDAP服务器。先看一下你的原始代码和异常信息：

原始代码 #

try {
 using (PrincipalContext ctx = new PrincipalContext(ContextType.Domain, "ldap.forumsys.com:389", "dc=example,dc=com", "cn=read-only-admin,dc=example,dc=com", "password")) {
 using (var searcher = new PrincipalSearcher(new UserPrincipal(ctx))) {
 foreach (var result in searcher.FindAll().Take(usersCount)) {
 DirectoryEntry de = result.GetUnderlyingObject() as DirectoryEntry;
 }
 }
}
catch(Exception ex) {
 Console.WriteLine(ex.Message);
}

异常堆栈 #

at System.DirectoryServices.AccountManagement.PrincipalContext.ReadServerConfig(String serverName, ServerProperties& properties)
at System.DirectoryServices.AccountManagement.PrincipalContext.DoServerVerifyAndPropRetrieval()
at System.DirectoryServices.AccountManagement.PrincipalContext..ctor(ContextType contextType, String name, String container, ContextOptions options, String userName, String password)
at System.DirectoryServices.AccountManagement.PrincipalContext..ctor(ContextType contextType, String name, String container, String userName, String password)
at ConsoleApp1.Program.GetGroups(String userName) in C:\Users\Simple Code\source\repos\ConsoleApp1\ConsoleApp1\Program.cs:line 48。

问题分析 #

ContextType.Domain是专门为Active Directory域环境设计的，它会尝试读取AD域特有的服务器配置信息（比如域控制器的架构、命名上下文等）。但ldap.forumsys.com是一个标准的OpenLDAP测试服务器，并不提供AD特有的配置数据，这就导致ReadServerConfig方法在读取配置时返回空值，最终触发空引用异常。

解决方法 #

你需要改用ContextType.DirectoryServer来适配独立LDAP服务器，并且显式指定绑定方式为SimpleBind（因为这个测试服务器使用简单绑定认证）。以下是修改后的可正常运行的代码：

try
{
    // 使用DirectoryServer类型，指定简单绑定选项
    using (PrincipalContext ctx = new PrincipalContext(
        ContextType.DirectoryServer,
        "ldap.forumsys.com:389",
        "dc=example,dc=com",
        ContextOptions.SimpleBind,
        "cn=read-only-admin,dc=example,dc=com",
        "password"))
    {
        using (var searcher = new PrincipalSearcher(new UserPrincipal(ctx)))
        {
            // 限制获取用户数量，避免一次性读取全部数据
            foreach (var result in searcher.FindAll().Take(5))
            {
                DirectoryEntry de = result.GetUnderlyingObject() as DirectoryEntry;
                if (de != null)
                {
                    // 示例：读取用户的CN和邮箱属性
                    Console.WriteLine($"用户名: {de.Properties["cn"].Value}");
                    Console.WriteLine($"邮箱: {de.Properties["mail"].Value}");
                    Console.WriteLine("---");
                }
            }
        }
    }
}
catch (Exception ex)
{
    Console.WriteLine($"异常信息: {ex.Message}");
    Console.WriteLine($"异常堆栈: {ex.StackTrace}");
}

关键修改点说明 #

• ContextType.DirectoryServer：告诉PrincipalContext这是一个独立的LDAP服务器，而非AD域，避免尝试读取AD特有的配置。
• ContextOptions.SimpleBind：显式指定使用简单绑定认证，这是该测试LDAP服务器支持的认证方式。
• 增加空值检查：在使用DirectoryEntry前增加if (de != null)判断，避免潜在的空引用问题。

这样修改后，你就能正常连接并查询该LDAP服务器的用户数据了。

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