Spring Boot连接Active Directory提示userDn未设置问题排查

核心异常根因 #

你看到的Property 'userDn' not set - anonymous context will be used日志，本质是Spring LDAP的上下文源实例没有拿到非空的userDn配置，并非AD账号格式的问题，按照以下优先级逐一排查即可：

• 检查自定义XML配置的加载状态
  Spring Boot默认不会自动识别src/main/resources下的applicationContext.xml配置文件，如果你没有在启动类上加@ImportResource("classpath:applicationContext.xml")注解引入该配置，你编写的mydomainContextSource Bean完全不会被Spring容器加载。此时程序实际使用的是Spring Boot自动装配生成的默认LDAP上下文源，这个默认源没有配置认证账号，自然会触发匿名连接的提示。
• 检查属性占位符的解析有效性
  你贴出的ldap.properties配置片段，缺少以下XML中引用的关键属性：
  • ldap.authentication.manager.password
  • ldap.authentication.server.urls
  • ldap.authentication.jndi.connect.timeout
  • ldap.authentication.jndi.read.timeout
  • ldap.authentication.jndi.security.level
    如果占位符无法解析到对应值，Spring会将对应属性设置为null，同样会触发未配置userDn的匿名连接逻辑。
• 检查Bean装配的冲突问题
  引入spring-boot-starter-data-ldap依赖后，Spring Boot会自动创建一个默认的上下文源Bean。如果你自定义的mydomainContextSource没有被LDAP模板正确引用，或者被自动装配的Bean覆盖，程序实际连接AD时会使用没有配置认证信息的默认Bean，你编写的所有认证配置都不会生效。
• 关于AD账号配置的说明
  你使用的原生LdapContextSource类本身没有单独的username属性，你注释掉的username配置是无效的，这类配置属于ActiveDirectoryLdapAuthenticationProvider的参数，不适用于直接操作AD记录的场景。AD绑定支持两种格式，都可以直接填入userDn属性：
  • 完整的传统DN格式：cn=myacct,dc=mydomain,dc=sunyjcc,dc=edu
  • UPN（用户主体名）格式：myacct@mydomain.sunyjcc.edu
    不需要额外做格式转换。

快速验证步骤 #

• 临时将userDn、password、urls的配置硬编码在XML的Bean属性中，不使用占位符替换，观察日志是否还会出现匿名连接提示。如果硬编码后问题消失，说明是属性占位符解析的问题；如果硬编码后依然报userDn未设置，说明你的自定义Bean根本没有被Spring容器加载。
• 启动后在代码中注入mydomainContextSource Bean，打印其userDn属性值，如果输出为null，即可定位是属性解析还是Bean加载的问题。

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