【SpringSecurity新手村系列】（2）整合 MyBatis 实现数据库认证

Flittly
0 阅读1分钟

第二章 整合 MyBatis 实现数据库认证

本章将介绍如何将 MySQL 数据库中的用户信息接入 Spring Security，告别配置文件中的内存用户。

在上一篇文章中，我们使用配置文件指定内存用户，这在开发测试环境中很方便，但实际项目里用户信息必然存储在数据库中。本篇文章将详细介绍如何整合 MyBatis，实现基于数据库的自定义认证。

一、问题切入

第一章中我们通过配置文件指定用户：

spring:
  security:
    user:
      name: flittly
      password: 123456

这种方式存在明显缺陷：

  • 用户信息写在代码中，无法动态管理
  • 密码以明文形式存储，安全性低
  • 生产环境不应使用配置文件明文密码
  • 无法扩展更多用户，无法支持注册/注销等功能

我们需要一个可扩展的方案，将数据库中的用户信息加载到 Spring Security 中。

二、解决方案：引入 MyBatis

在 pom.xml 中添加 MyBatis Starter 和 MySQL 驱动：

<dependency>
    <groupId>org.mybatis.spring.boot</groupId>
    <artifactId>mybatis-spring-boot-starter</artifactId>
    <version>4.0.1</version>
</dependency>

<dependency>
    <groupId>com.mysql</groupId>
    <artifactId>mysql-connector-j</artifactId>
    <scope>runtime</scope>
</dependency>

三、配置数据源连接

在 application.yml 中配置数据库连接：

spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://localhost:3306/spring_security_demo
    username: root
    password: 123456

mybatis:
  mapper-locations: classpath*:mapper/*.xml
  type-aliases-package: cn.edu.nnu.opengms.ss02.entity

四、原理阐释：认证流程

4.1 核心接口

Spring Security 的认证体系围绕以下核心接口展开：

接口

作用

UserDetailsService

根据用户名加载用户信息

UserDetails

用户信息封装对象

PasswordEncoder

密码验证器

Authentication

认证令牌

4.2 认证流程详解

整个认证流程涉及多个组件的协作：

用户提交登录表单（用户名 + 密码）
    ↓
UsernamePasswordAuthenticationFilter 拦截请求
    ↓ 提取用户名
DaoAuthenticationProvider.getUserDetails(username)
    ↓ 调用
UserDetailsService.loadUserByUsername(username)
    ↓ 调用 MyBatis Mapper
从数据库查询用户信息
    ↓ 返回
构建 UserDetails 对象（含密码、权限信息）
    ↓
PasswordEncoder.matches() 验证密码
    ↓ 匹配成功
Authentication 认证成功，创建认证令牌
    ↓
SecurityContextHolder.getContext().setAuthentication()
    ↓
重定向到成功页面

UserDetailsService 是 Spring Security 认证体系的核心接口，负责根据用户名加载用户信息。

4.3 密码编码器

Spring Security 7.x 要求必须配置密码编码器，支持多种编码方式：

  • BCrypt：推荐，单向哈希算法，内置随机盐
  • Argon2：现代密码哈希算法
  • PBKDF2：基于密钥推导
  • Scrypt：计算密集型算法

BCrypt 是目前最常用的选择，它具有以下特点：

  • 单向哈希：无法从哈希值反向推导原始密码
  • 内置盐：每次加密生成不同的哈希值，即使相同密码也不一样
  • 强度可调：通过 work factor 调整计算时间

五、代码实现

5.1 Users 实体类

对应数据库中的 users 表：

@Data
public class Users implements Serializable {
    private Long id;
    private String username;
    private String password;
    private String email;
    private String phone;
    private Boolean enabled;
    private Date createTime;
    private Date updateTime;
}

5.2 Mapper 接口

定义根据用户名查询用户的方法：

@Mapper
public interface UsersMapper {
    Users selectByLoginAct(@Param("loginAct") String loginAct);
}

5.3 Mapper XML

<mapper namespace="cn.edu.nnu.opengms.ss02.mapper.UsersMapper">
    <select id="selectByLoginAct" resultMap="BaseResultMap">
        SELECT * FROM users WHERE username = #{loginAct}
    </select>
</mapper>

5.4 UserService 接口

定义服务接口，继承 UserDetailsService：

public interface UserService extends UserDetailsService {
    // 只需实现 loadUserByUsername 方法
}

5.5 UserServiceImpl 实现

核心实现类，从数据库加载用户：

@Service
public class UserServiceImpl implements UserService {
    @Resource
    private UsersMapper usersMapper;

    @Override
    public UserDetails loadUserByUsername(String username) throws UsernameNotFoundException {
        Users users = usersMapper.selectByLoginAct(username);
        if (users == null) {
            throw new UsernameNotFoundException("用户不存在");
        }
        
        // 将数据库用户转换为 Spring Security 的 UserDetails 对象
        UserDetails userDetails = User.builder()
                .username(users.getUsername())
                .password(users.getPassword())
                .authorities(AuthorityUtils.NO_AUTHORITIES)
                .build();
        return userDetails;
    }
}

这里的 User 是 Spring Security 提供的构建器类，用于简化 UserDetails 对象的创建。

5.6 PasswordEncoder 配置

在 Spring 容器中注册密码编码器：

@Configuration
public class SecurityConfig {
    @Bean
    public PasswordEncoder passwordEncoder() {
        // BCrypt：单向哈希算法，自带随机盐，安全性高
        return new BCryptPasswordEncoder();
    }
}

六、数据库准备

创建数据库和用户表：

CREATE TABLE `users` (
    `id` BIGINT PRIMARY KEY AUTO_INCREMENT,
    `username` VARCHAR(50) NOT NULL UNIQUE,
    `password` VARCHAR(100) NOT NULL,
    `email` VARCHAR(100),
    `phone` VARCHAR(20),
    `enabled` TINYINT(1) DEFAULT 1,
    `create_time` DATETIME DEFAULT CURRENT_TIMESTAMP,
    `update_time` DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

注意：数据库中的密码必须是 BCrypt 加密后的密文，可以使用 BCrypt 工具类生成。

6.1 使用 IDEA 插件 Free MyBatis Tool 生成 Mapper 与 XML

在这个模块里，你也可以使用 IntelliJ IDEA 插件 Free MyBatis Tool 来快速生成基础代码，减少手写重复劳动。

常见流程如下：

  1. 在 IDEA 安装插件：Free MyBatis Tool
  2. 配置数据源并连接目标数据库（如 spring_security_demo）
  3. 选中目标表（如 users）后执行代码生成
  4. 生成实体类、Mapper 接口、Mapper XML（以及可选 Service/Controller 模板）

生成后建议重点检查以下几项（这一步很重要）：

  • namespace 是否与 Mapper 接口全限定名一致
  • XML 中 id 是否与接口方法名一致（如 selectByLoginAct）
  • mapper-locations 是否与 XML 实际路径一致
  • 参数名与 SQL 占位符是否一致（必要时配合 @Param）

示例（生成后可按项目需要补充自定义查询）：

@Mapper
public interface UsersMapper {
    Users selectByLoginAct(@Param("loginAct") String loginAct);
}


<mapper namespace="cn.edu.nnu.opengms.ss02.mapper.UsersMapper">
    <select id="selectByLoginAct" resultMap="BaseResultMap">
        SELECT * FROM users WHERE username = #{loginAct}
    </select>
</mapper>

提示：代码生成能提高效率，但不要完全依赖默认模板。安全相关字段（如 password、enabled）和登录查询 SQL 仍建议人工复核。

七、核心概念总结

概念

说明

UserDetailsService

自定义认证服务接口，loadUserByUsername() 方法由框架自动调用

UserDetails

用户信息封装对象，包含用户名、密码、权限

UserDetailsBuilder

构建器，简化 UserDetails 对象创建

PasswordEncoder

密码编码器，Spring Security 7.x 必须配置

认证流程

框架自动调用数据库查询，验证密码

八、总结

本篇文章介绍了以下核心概念：

  1. UserDetailsService：自定义认证服务接口
  2. UserDetails：用户信息封装对象
  3. PasswordEncoder：密码编码器，必须配置
  4. 认证流程：框架自动调用数据库查询，验证密码
  5. BCrypt：推荐使用的密码编码算法

下一篇文章我们将介绍如何自定义登录页面。

编辑者：Flittly
更新时间：2026年4月

avatar
文章
阅读
粉丝