石嘴山市网站建设_网站建设公司_云服务器_seo优化

书 接 上 回、我 们 分 析 下 AuthController.@PostMapping("/login") 接 口 作 为 切 入 点 进 行 深 入 浅 出 剖 析 ~ ~

下 面 我 们 以 小 明 的 authenticateUser 方 法 为 入 口 ， 详 细 拆 解 认 证 执 行 的 ** 完 整 流 程 闭 环 ** ， 并 深 入 分 析 Authentication authentication = authenticationManager.authenticate(...) 的 ** 调 用 链 路 ** ， 同 时 说 明 ** 自 定 义 类 ** 在 其 中 的 作 用 。 代 码 块 中 汉 字 正 常 书 写 ， 代 码 块 外 汉 字 间 保 持 2 个 空 格 。

一 、 完 整 认 证 流 程 闭 环

认 证 流 程 从 用 户 提 交 登 录 请 求 开 始 ， 到 返 回 JWT 响 应 结 束 ， 形 成 如 下 闭 环 ：

用户提交登录请求

接收LoginRequest参数

创建UsernamePasswordAuthenticationToken

调用AuthenticationManager.authenticate

DaoAuthenticationProvider处理认证

UserDetailsService查询用户

PasswordEncoder验证密码

构建认证后Authentication对象

设置SecurityContextHolder

JwtService生成JWT令牌

封装JwtResponse响应

返回响应给用户

流 程 闭 环 详 细 步 骤 （ 结 合 代 码 ）

1. 接 收 登 录 请 求 （ 自 定 义 DTO 入 口 ）

用 户 通 过 前 端 提 交 用 户 名 和 密 码 ， 请 求 体 被 @RequestBody LoginRequest loginRequest 接 收 。

** 自 定 义 类 LoginRequest 作 用 ** ： 封 装 登 录 请 求 参 数 （ 用 户 名 、 密 码 ） ， 代 码 如 下 ：

public class LoginRequest {

private String username; // 用 户 名

private String password; // 密 码

// Getters and Setters

}

2. 创 建 认 证 请 求 对 象 （ Spring Security 自 带 类 ）

通 过 new UsernamePasswordAuthenticationToken(loginRequest.getUsername(), loginRequest.getPassword()) 创 建 认 证 请 求 对 象 。

** Spring Security 自 带 类 UsernamePasswordAuthenticationToken 作 用 ** ：

来 源 ： org.springframework.security.authentication.UsernamePasswordAuthenticationToken

作 用 ： 封 装 用 户 名 密 码 认 证 请 求 ， 初 始 状 态 下 authorities （ 权 限 ） 为 空 ， 相 当 于 “ 未 盖 章 的 通 行 证 ” 。

3. 调 用 AuthenticationManager.authenticate() （ 核 心 调 用 链 路 ， 下 文 详 解 ）

将 上 述 UsernamePasswordAuthenticationToken 传 入 authenticationManager.authenticate() ， 触 发 认 证 流 程 。

4. 认 证 成 功 后 设 置 安 全 上 下 文

认 证 成 功 返 回 填 充 完 权 限 的 Authentication 对 象 ， 通 过 SecurityContextHolder.getContext().setAuthentication(authentication) 绑 定 到 当 前 线 程 。

5. 生 成 JWT 令 牌 （ 自 定 义 JwtService ）

调 用 jwtService.generateToken(authentication) 生 成 JWT ， 用 于 后 续 无 状 态 认 证 。

** 自 定 义 类 JwtService 作 用 ** ： 封 装 JWT 生 成 / 验 证 逻 辑 ， 核 心 方 法 generateToken(Authentication authentication) 从 authentication 中 提 取 用 户 名 、 权 限 等 信 息 ， 按 规 则 生 成 签 名 令 牌 。

6. 封 装 响 应 数 据 （ 自 定 义 DTO ）

从 authentication.getPrincipal() 获 取 UserDetailsImpl （ 自 定 义 用 户 详 情 类 ） ， 提 取 用 户 ID 、 用 户 名 、 邮 箱 、 角 色 等 信 息 ， 封 装 为 JwtResponse 返 回 。

** 自 定 义 类 作 用 ** ：

UserDetailsImpl ： 实 现 Spring Security 的 UserDetails 接 口 ， 封 装 用 户 基 础 信 息 （ ID 、 用 户 名 、 邮 箱 ） 和 权 限 （ 角 色 / 权 限 字 符 串 ） ， 代 码 示 例 ：

public class UserDetailsImpl implements UserDetails {

private Long id;

private String username;

private String email;

private String password;

private Collection<? extends GrantedAuthority> authorities;

// 实现UserDetails接口方法（getAuthorities()等）

// Getters and Setters

}

JwtResponse ： 封 装 JWT 响 应 数 据 （ token 、 用 户 ID 、 用 户 名 、 邮 箱 、 角 色 列 表 ） ， 代 码 示 例 ：

public class JwtResponse {

private String token;

private Long id;

private String username;

private String email;

private List<String> roles;

// Constructor, Getters and Setters

}

7. 返 回 响 应 与 异 常 处 理

认 证 成 功 返 回 ResponseEntity.ok(response) ； 失 败 （ 如 密 码 错 误 ） 捕 获 BadCredentialsException ， 返 回 401 错 误 。

二 、 AuthenticationManager.authenticate(...) 调 用 链 路 详 解

这 段 代 码 是 认 证 流 程 的 ** 核 心 枢 纽 ** ， 其 内 部 调 用 链 路 如 下 ：

调 用 链 路 示 意 图

authenticationManager.authenticate(token)

↓

AuthenticationManager （ 接 口 ， 默 认 实 现 ProviderManager ）

↓ 遍 历 注 册 的 AuthenticationProvider ， 找 到 支 持 UsernamePasswordAuthenticationToken 的 Provider

DaoAuthenticationProvider （ Spring Security 自 带 ， 处 理 用 户 名 密 码 认 证 ）

↓ 调 用 UserDetailsService.loadUserByUsername(username) （ 自 定 义 实 现 ）

UserServiceImpl （ 自 定 义 ， 实 现 UserDetailsService ）

↓ 从 数 据 库 查 询 用 户 信 息 ， 封 装 为 UserDetailsImpl 返 回

DaoAuthenticationProvider

↓ 用 PasswordEncoder.matches(rawPassword, encodedPassword) 验 证 密 码

PasswordEncoder （ 自 定 义 BCryptPasswordEncoder ）

↓ 验 证 通 过 ， 构 建 已 认 证 Authentication 对 象

new UsernamePasswordAuthenticationToken(principal, credentials, authorities)

↓ 返 回 给 authenticationManager.authenticate()

Authentication （ 认 证 成 果 ）

链 路 关 键 环 节 注 释

1. AuthenticationManager ： 认 证 总 调 度 员

** 来 源 ** ： Spring Security 核 心 接 口 org.springframework.security.authentication.AuthenticationManager ， 默 认 实 现 为 ProviderManager 。

** 作 用 ** ： 接 收 Authentication 认 证 请 求 ， 协 调 多 个 AuthenticationProvider （ 认 证 提 供 者 ） 完 成 认 证 。

** 入 参 ** ： 未 认 证 的 UsernamePasswordAuthenticationToken （ 含 用 户 名 、 明 文 密 码 ） 。

** 出 参 ** ： 认 证 成 功 后 的 Authentication 对 象 （ 含 用 户 详 情 、 权 限 集 合 ） 。

2. DaoAuthenticationProvider ： 认 证 执 行 者 （ Spring Security 自 带 ）

** 来 源 ** ： org.springframework.security.authentication.dao.DaoAuthenticationProvider 。

** 作 用 ** ： 处 理 用 户 名 密 码 认 证 的 具 体 逻 辑 ， 依 赖 UserDetailsService 和 PasswordEncoder 。

** 核 心 步 骤 ** ：

a. 调 用 UserDetailsService.loadUserByUsername(username) 查 询 用 户 ；

b. 用 PasswordEncoder 比 对 明 文 密 码 与 数 据 库 中 的 加 密 密 码 ；

c. 验 证 通 过 后 ， 构 建 已 认 证 的 UsernamePasswordAuthenticationToken （ 填 充 authorities 权 限 ） 。

3. UserDetailsService ： 用 户 信 息 查 询 器 （ 自 定 义 实 现 ）

** 来 源 ** ： Spring Security 核 心 接 口 org.springframework.security.core.userdetails.UserDetailsService 。

** 自 定 义 实 现 类 UserServiceImpl 作 用 ** ： 从 数 据 库 查 询 用 户 信 息 ， 封 装 为 UserDetails 对 象 （ 此 处 为 UserDetailsImpl ） 返 回 。

** 核 心 方 法 ** ：

@Override

public UserDetails loadUserByUsername(String username) throws UsernameNotFoundException {

// 1. 从数据库查询用户（自定义User实体类）

User user = userRepository.findByUsername(username)

.orElseThrow(() -> new UsernameNotFoundException("用户不存在"));

// 2. 封装为UserDetailsImpl（含权限）

return UserDetailsImpl.build(user);

}

4. PasswordEncoder ： 密 码 验 证 器 （ 自 定 义 配 置 ）

** 来 源 ** ： Spring Security 核 心 接 口 org.springframework.security.crypto.password.PasswordEncoder ， 此 处 用 自 定 义 BCryptPasswordEncoder 。

** 作 用 ** ： 验 证 明 文 密 码 与 数 据 库 中 BCrypt 加 密 密 码 是 否 匹 配 。

** 调 用 代 码 ** ：

if (!passwordEncoder.matches(loginRequest.getPassword(), userDetails.getPassword())) {

throw new BadCredentialsException("用户名或密码错误");

}

5. 构 建 认 证 后 Authentication 对 象

认 证 通 过 后 ， DaoAuthenticationProvider 创 建 ** 已 认 证 ** 的 UsernamePasswordAuthenticationToken ：

// 参数：principal=用户详情（UserDetailsImpl），credentials=null（密码已清空），authorities=用户权限

new UsernamePasswordAuthenticationToken(userDetails, null, userDetails.getAuthorities());

三 、 自 定 义 类 在 流 程 中 的 核 心 作 用 总 结

** 自 定 义 类 ** ** 作 用 描 述 ** ** 关 键 方 法 / 属 性 **

LoginRequest 封 装 登 录 请 求 参 数 （ 用 户 名 、 密 码 ） getUsername() 、 getPassword()

UserDetailsImpl 实 现 UserDetails 接 口 ， 封 装 用 户 详 情 （ ID 、 用 户 名 、 邮 箱 、 权 限 ） getAuthorities() （ 返 回 权 限 集 合 ） 、 getUsername()

UserServiceImpl 实 现 UserDetailsService ， 从 数 据 库 查 询 用 户 并 封 装 为 UserDetailsImpl loadUserByUsername(String username)

JwtService 生 成 / 验 证 JWT 令 牌 ， 封 装 JWT 算 法 逻 辑 generateToken(Authentication authentication)

JwtResponse 封 装 JWT 响 应 数 据 （ token 、 用 户 信 息 、 角 色 ） token 、 id 、 roles

💡 小 明 的 流 程 体 会

认 证 流 程 闭 环 像 一 场 “ 身 份 验 证 演 习 ” ：

用 户 递 交 “ 身 份 申 请 ” （ LoginRequest ） ；

框 架 发 放 “ 临 时 通 行 证 ” （ UsernamePasswordAuthenticationToken ） ；

“ 认 证 官 ” （ AuthenticationManager ） 调 度 “ 审 查 员 ” （ DaoAuthenticationProvider ） ；

“ 审 查 员 ” 查 阅 “ 档 案 库 ” （ UserServiceImpl 查 数 据 库 ） ， 用 “ 密 码 对 比 仪 ” （ PasswordEncoder ） 验 证 ；

通 过 后 发 放 “ 正 式 身 份 证 ” （ 认 证 后 Authentication ） ， 存 入 “ 工 作 台 ” （ SecurityContextHolder ） ；

最 后 制 作 “ 长 期 通 行 证 ” （ JWT ） 返 还 用 户 。