Spring Security中实现UserDetails的原因及AuthenticationManagerBuilder作用

为什么自定义User实体需要实现UserDetails接口 #

• UserDetails是Spring Security定义的用户身份数据标准契约，封装了框架做身份校验必须的核心字段：用户名、密码、权限集合、账户状态（是否过期/锁定/启用等）。框架默认的认证组件（比如你用到的DaoAuthenticationProvider）只会识别UserDetails类型的返回值，你自定义的User实体实现该接口后，框架可以直接读取校验所需的所有信息，不需要额外写适配逻辑。如果不实现UserDetails接口，你需要完全自定义重写DaoAuthenticationProvider的校验逻辑，反而会增加不必要的开发量。
• 认证通过后，UserDetails实例会被封装到Authentication对象存入SecurityContext上下文，后续你在应用任意位置获取当前登录用户信息时，有统一的标准结构，就算后续自定义实体的业务字段变更也不影响框架核心认证逻辑的运行。

为什么需要使用AuthenticationManagerBuilder #

• Spring Security的认证流程核心入口是AuthenticationManager，它负责管理所有注册的AuthenticationProvider，调度不同认证类型的校验逻辑。AuthenticationManagerBuilder是框架提供的专门用于构建、配置AuthenticationManager的工具类，不需要你手动组装AuthenticationManager的所有依赖，大幅降低配置复杂度。
• 在继承WebSecurityConfigurerAdapter的配置体系中，你通过AuthenticationManagerBuilder注册自定义的DaoAuthenticationProvider、用户详情服务、密码编码器等组件后，框架会自动将这些配置组装到全局生效的AuthenticationManager中，无需手动注册到Spring上下文即可生效。
• 后续扩展认证方式时（比如新增短信验证码登录、第三方登录等），只需要通过AuthenticationManagerBuilder注册对应类型的AuthenticationProvider即可，不需要修改核心认证调度逻辑，框架会自动按优先级匹配对应认证Provider处理请求。

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