# 第二章 整合 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月

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

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

本文讲解如何将 MySQL 与 MyBatis 接入 Spring Security，通过自定义 UserDetailsService 实现数据库认证，并说明 PasswordEncoder、Mapper/XML 与登录流程的关键实现点。

后端

数据库

安全

本文详细介绍如何整合MyBatis实现SpringSecurity数据库认证，包含MySQL配置、UserDetailsService实现、密码编码器设置等关键步骤，帮助开发者从内存认证过渡到数据库认证，提升系统安全性。

SQL数据库

容器

MySQL

2026采购季 | AI焕新·智启新局

tencentdb-catalog

腾讯云数据库特惠，新用户首单0.5折起


文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

【SpringSecurity新手村系列】（2）整合 MyBatis 实现数据库认证-腾讯云开发者社区-腾讯云

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

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

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐