SpringBoot+MyBatis实现员工账户管理系统的核心功能

SpringBootMyBatis员工账户管理

于 2026-07-03 09:44:14 修改

·本内容遵循CC 4.0 BY-SA版权协议

1. 项目背景与核心需求

最近在开发一个名为"苍穹外卖"的后台管理系统，其中员工账户管理模块需要实现三个核心功能：账户启用/禁用、账户信息修改以及分页查询。这些功能看似基础，但在实际开发中涉及到权限控制、数据一致性、接口设计等多个技术要点。

这个模块的典型使用场景包括：

管理员发现某个员工离职，需要立即禁用其账户
员工职位变动时需要修改其部门信息
人事部门需要查看所有员工的状态并进行批量操作

2. 技术架构设计

2.1 整体技术栈

项目采用标准的SpringBoot+MyBatis技术栈：

Spring Boot 2.7.x
MyBatis-Plus 3.5.x
MySQL 8.0
Redis 6.x（用于缓存和会话管理）

2.2 数据库设计

员工表(employee)关键字段：

SQL

CREATE TABLE `employee` (

`id` bigint NOT NULL COMMENT '主键',

`name` varchar(32) COLLATE utf8mb4_bin NOT NULL COMMENT '姓名',

`username` varchar(32) COLLATE utf8mb4_bin NOT NULL COMMENT '用户名',

`password` varchar(64) COLLATE utf8mb4_bin NOT NULL COMMENT '密码',

`phone` varchar(11) COLLATE utf8mb4_bin NOT NULL COMMENT '手机号',

`sex` varchar(2) COLLATE utf8mb4_bin NOT NULL COMMENT '性别',

`id_number` varchar(18) COLLATE utf8mb4_bin NOT NULL COMMENT '身份证号',

`status` int NOT NULL DEFAULT '1' COMMENT '状态 0:禁用，1:启用',

`create_time` datetime NOT NULL COMMENT '创建时间',

`update_time` datetime NOT NULL COMMENT '更新时间',

`create_user` bigint NOT NULL COMMENT '创建人',

`update_user` bigint NOT NULL COMMENT '修改人',

PRIMARY KEY (`id`),

UNIQUE KEY `idx_username` (`username`)

) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin;

3. 核心功能实现

3.1 启用/禁用账户功能

Controller层实现：

JAVA

@PostMapping("/status/{status}")

public Result<String> updateStatus(@PathVariable Integer status, Long id) {

employeeService.updateStatus(status, id);

return Result.success(status == 1 ? "启用成功" : "禁用成功");

}

Service层实现要点：

检查操作权限（只有管理员可以执行此操作）
检查目标账户是否存在
防止禁用当前登录账户
使用MyBatis-Plus的LambdaUpdateWrapper进行高效更新

JAVA

public void updateStatus(Integer status, Long id) {

// 1. 权限校验

Long currentUserId = BaseContext.getCurrentId();

if (!isAdmin(currentUserId)) {

throw new BusinessException(MessageConstant.NO_PERMISSION);

}

// 2. 防止禁用自己

if (currentUserId.equals(id) && status == 0) {

throw new BusinessException(MessageConstant.CANNOT_DISABLE_SELF);

}

// 3. 更新状态

LambdaUpdateWrapper<Employee> updateWrapper = new LambdaUpdateWrapper<>();

updateWrapper.eq(Employee::getId, id)

.set(Employee::getStatus, status)

.set(Employee::getUpdateTime, LocalDateTime.now())

.set(Employee::getUpdateUser, currentUserId);

if (!update(updateWrapper)) {

throw new BusinessException(MessageConstant.ACCOUNT_NOT_FOUND);

}

// 4. 记录操作日志

logService.recordOperationLog(...);

}

3.2 修改员工信息功能

DTO设计：

JAVA

@Data

public class EmployeeDTO {

private Long id;

@NotBlank(message = "姓名不能为空")

private String name;

@NotBlank(message = "用户名不能为空")

private String username;

@Pattern(regexp = "^1[3-9]\\d{9}$", message = "手机号格式不正确")

private String phone;

@NotBlank(message = "性别不能为空")

private String sex;

@NotBlank(message = "身份证号不能为空")

@Pattern(regexp = "^[1-9]\\d{5}(18|19|20)\\d{2}(0[1-9]|1[0-2])(0[1-9]|[12]\\d|3[01])\\d{3}[0-9Xx]$",

message = "身份证号格式不正确")

private String idNumber;

}

Service层关键逻辑：

JAVA

@Transactional

public void updateEmployee(EmployeeDTO employeeDTO) {

// 1. 基本校验

if (employeeDTO.getId() == null) {

throw new BusinessException(MessageConstant.ILLEGAL_OPERATION);

}

// 2. 用户名唯一性校验

LambdaQueryWrapper<Employee> queryWrapper = new LambdaQueryWrapper<>();

queryWrapper.eq(Employee::getUsername, employeeDTO.getUsername())

.ne(Employee::getId, employeeDTO.getId());

if (count(queryWrapper) > 0) {

throw new BusinessException(MessageConstant.USERNAME_EXISTS);

}

// 3. 更新操作

Employee employee = new Employee();

BeanUtils.copyProperties(employeeDTO, employee);

employee.setUpdateTime(LocalDateTime.now());

employee.setUpdateUser(BaseContext.getCurrentId());

if (!updateById(employee)) {

throw new BusinessException(MessageConstant.ACCOUNT_NOT_FOUND);

}

3.3 分页查询功能

分页查询参数封装：

JAVA

@Data

public class EmployeePageQueryDTO {

private String name;

private Integer page = 1;

private Integer pageSize = 10;

}

分页查询实现：

JAVA

public PageResult pageQuery(EmployeePageQueryDTO queryDTO) {

Page<Employee> page = new Page<>(queryDTO.getPage(), queryDTO.getPageSize());

LambdaQueryWrapper<Employee> queryWrapper = new LambdaQueryWrapper<>();

queryWrapper.like(StringUtils.isNotBlank(queryDTO.getName()),

Employee::getName, queryDTO.getName())

.orderByDesc(Employee::getUpdateTime);

page(page, queryWrapper);

return new PageResult(page.getTotal(), page.getRecords());

}

4. 关键问题与解决方案

4.1 并发修改问题

当多个管理员同时修改同一个员工信息时，可能出现数据不一致问题。解决方案：

使用乐观锁机制：

JAVA

@Version

private Integer version;

更新时检查版本号：

JAVA

LambdaUpdateWrapper<Employee> updateWrapper = new LambdaUpdateWrapper<>();

updateWrapper.eq(Employee::getId, employeeDTO.getId())

.eq(Employee::getVersion, employeeDTO.getVersion())

.set(Employee::getVersion, employeeDTO.getVersion() + 1);

4.2 敏感信息处理

员工密码、身份证号等敏感信息需要特殊处理：

查询时不返回密码字段：

JAVA

@TableField(select = false)

private String password;

身份证号脱敏显示：

JAVA

public String getIdNumber() {

if (StringUtils.isBlank(idNumber) || idNumber.length() < 8) {

return idNumber;

}

return idNumber.substring(0, 3) + "****" + idNumber.substring(idNumber.length() - 4);

}

4.3 操作日志记录

所有关键操作都需要记录日志：

JAVA

@Aspect

@Component

@Slf4j

public class OperationLogAspect {

@Autowired

private OperationLogService operationLogService;

@Around("@annotation(operationLog)")

public Object around(ProceedingJoinPoint joinPoint, OperationLog operationLog) throws Throwable {

// 获取操作描述

String operation = operationLog.value();

// 执行目标方法

Object result = joinPoint.proceed();

// 记录日志

OperationLogEntity logEntity = new OperationLogEntity();

logEntity.setOperation(operation);

// 设置其他参数...

operationLogService.save(logEntity);

return result;

}

5. 性能优化实践

5.1 缓存优化

频繁访问的员工信息可以加入缓存：

JAVA

@Cacheable(value = "employee", key = "#id")

public Employee getById(Long id) {

return getBaseMapper().selectById(id);

}

@CacheEvict(value = "employee", key = "#employeeDTO.id")

public void updateEmployee(EmployeeDTO employeeDTO) {

// 更新逻辑

}

5.2 批量操作优化

当需要批量启用/禁用账户时：

JAVA

@Transactional

public void batchUpdateStatus(Integer status, List<Long> ids) {

if (CollectionUtils.isEmpty(ids)) {

return;

}

Long currentUserId = BaseContext.getCurrentId();

LocalDateTime now = LocalDateTime.now();

List<Employee> updateList = ids.stream()

.filter(id -> !id.equals(currentUserId) || status != 0)

.map(id -> {

Employee employee = new Employee();

employee.setId(id);

employee.setStatus(status);

employee.setUpdateTime(now);

employee.setUpdateUser(currentUserId);

return employee;

}).collect(Collectors.toList());

if (!updateBatchById(updateList)) {

throw new BusinessException("批量操作失败");

}

6. 安全防护措施

6.1 权限控制

使用Spring Security实现方法级权限控制：

JAVA

@PreAuthorize("hasAuthority('employee:edit')")

@PostMapping("/status/{status}")

public Result<String> updateStatus(@PathVariable Integer status, Long id) {

// 方法实现

}

6.2 参数校验

使用Hibernate Validator进行参数校验：

JAVA

@PostMapping

public Result<String> save(@Valid @RequestBody EmployeeDTO employeeDTO) {

// 保存逻辑

}

6.3 SQL注入防护

MyBatis-Plus默认使用预编译语句，但自定义SQL需要注意：

JAVA

@Select("SELECT * FROM employee WHERE name = #{name}")

List<Employee> findByName(@Param("name") String name);

7. 测试要点

7.1 单元测试示例

JAVA

@Test

public void testUpdateStatus() {

// 准备测试数据

Long adminId = 1L;

Long employeeId = 2L;

BaseContext.setCurrentId(adminId);

// 测试禁用操作

employeeService.updateStatus(0, employeeId);

Employee employee = employeeService.getById(employeeId);

assertEquals(0, employee.getStatus());

// 测试启用操作

employeeService.updateStatus(1, employeeId);

employee = employeeService.getById(employeeId);

assertEquals(1, employee.getStatus());

// 测试禁用自己

assertThrows(BusinessException.class, () -> {

employeeService.updateStatus(0, adminId);

});

}

7.2 接口测试用例

无权限用户尝试修改状态 - 应返回403
修改不存在的员工ID - 应返回404
修改自己的状态为禁用 - 应返回业务异常
并发修改测试 - 应保证数据一致性

8. 部署注意事项

生产环境需要关闭Swagger等开发工具
建议使用Nginx配置HTTPS
数据库连接池配置优化：

YAML

spring:

datasource:

hikari:

maximum-pool-size: 20

minimum-idle: 5

connection-timeout: 30000

9. 扩展功能建议

员工账户操作短信通知
账户状态变更历史记录
基于角色的更细粒度权限控制
员工离职自动交接流程

在实际开发中，我发现账户状态管理最容易被忽视的是并发操作问题和操作日志完整性。建议在项目初期就建立完善的操作日志体系，这对后续的审计和问题排查非常重要。另外，对于敏感操作如账户禁用，可以考虑增加二次确认机制，避免误操作。