1. 项目背景与意义随着企业信息化建设的不断深入传统的手工台账和单机办公模式已难以满足日常运营对效率、规范和数据安全的要求。越来越多的企业希望将人员管理、权限控制、业务数据维护等后台工作统一迁移到 Web 平台之上实现集中化、流程化和可追溯的管理。Spring Boot 作为当前 Java 生态中主流的微服务开发框架凭借自动配置、内嵌容器、起步依赖等特性大幅降低了企业级应用的搭建成本。基于 Spring Boot 开发企业后台管理系统既能够快速落地又保留了良好的扩展性和维护性是许多中小型企业在数字化转型过程中的务实选择。本课题的研究意义主要体现在以下三个方面提升管理效率将分散的线下流程线上化减少重复劳动提高数据流转速度。强化权限安全通过统一的认证与授权机制保障不同角色只能访问其职责范围内的功能与数据。沉淀可复用架构梳理出一套层次清晰、易于扩展的后台系统基础框架为后续业务模块的持续迭代提供支撑。2. 系统技术栈本系统采用前后端分离的开发模式后端以 Spring Boot 为核心前端使用 Vue 生态构建管理界面数据库选用 MySQL缓存与会话管理借助 Redis 完成。整体技术选型兼顾了开发效率、运行性能与社区生态的成熟度。层次技术选型主要作用后端框架Spring Boot 2.7提供自动配置、依赖管理与内嵌容器简化项目搭建持久层MyBatis-Plus简化单表 CRUD 操作内置分页与条件构造器安全认证Spring Security JWT实现登录认证、接口鉴权与无状态会话管理数据库MySQL 8.0存储用户、角色、菜单及业务数据缓存中间件Redis缓存验证码、用户 Token 与热点数据前端框架Vue 3 Element Plus构建后台管理界面与通用组件接口文档Knife4j自动生成在线接口文档便于前后端联调3. 系统功能模块设计企业后台管理系统通常围绕“用户—角色—权限—业务数据”这条主线进行设计。本系统在功能上划分为以下几个核心模块登录认证模块支持账号密码登录、图形验证码校验登录成功后签发 JWT Token。用户管理模块维护系统用户的基本信息支持新增、编辑、删除、重置密码与启用停用操作。角色管理模块维护角色信息并为角色分配菜单权限与数据权限。菜单管理模块以树形结构维护系统菜单与按钮权限标识动态生成前端路由。部门管理模块维护企业组织架构支持树形展示与层级查询。日志管理模块记录用户登录日志与操作日志便于安全审计与问题追溯。4. 数据库设计数据库设计遵循第三范式并结合实际查询场景进行适度冗余。核心表包括用户表、角色表、菜单表、用户角色关联表、角色菜单关联表以及部门表。CREATE TABLE sys_user ( id BIGINT AUTO_INCREMENT PRIMARY KEY, username VARCHAR(50) NOT NULL COMMENT 登录账号, password VARCHAR(100) NOT NULL COMMENT 加密密码, nickname VARCHAR(50) DEFAULT NULL COMMENT 显示名称, dept_id BIGINT DEFAULT NULL COMMENT 所属部门, status TINYINT DEFAULT 1 COMMENT 状态1启用 0停用, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, UNIQUE KEY uk_username (username) ) COMMENT 系统用户表; CREATE TABLE sys_role ( id BIGINT AUTO_INCREMENT PRIMARY KEY, role_name VARCHAR(50) NOT NULL COMMENT 角色名称, role_key VARCHAR(50) NOT NULL COMMENT 角色标识, status TINYINT DEFAULT 1 COMMENT 状态, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, UNIQUE KEY uk_role_key (role_key) ) COMMENT 系统角色表; CREATE TABLE sys_menu ( id BIGINT AUTO_INCREMENT PRIMARY KEY, parent_id BIGINT DEFAULT 0 COMMENT 父菜单ID, menu_name VARCHAR(50) NOT NULL COMMENT 菜单名称, menu_type CHAR(1) DEFAULT M COMMENT 类型M目录 C菜单 F按钮, path VARCHAR(200) DEFAULT NULL COMMENT 路由地址, perms VARCHAR(100) DEFAULT NULL COMMENT 权限标识, sort INT DEFAULT 0 COMMENT 排序, visible TINYINT DEFAULT 1 COMMENT 是否显示 ) COMMENT 系统菜单表; CREATE TABLE sys_user_role ( user_id BIGINT NOT NULL, role_id BIGINT NOT NULL, PRIMARY KEY (user_id, role_id) ) COMMENT 用户角色关联表; CREATE TABLE sys_role_menu ( role_id BIGINT NOT NULL, menu_id BIGINT NOT NULL, PRIMARY KEY (role_id, menu_id) ) COMMENT 角色菜单关联表;5. 核心代码实现本节选取登录认证、统一响应封装、权限校验和用户管理四个关键环节展示系统的核心实现思路。5.1 统一响应结果封装为保证前后端接口数据格式一致系统定义了统一的响应对象 Result所有控制器方法均返回该类型。Data public class ResultT { private Integer code; private String message; private T data; public static T ResultT success(T data) { ResultT result new Result(); result.setCode(200); result.setMessage(操作成功); result.setData(data); return result; } public static T ResultT error(String message) { ResultT result new Result(); result.setCode(500); result.setMessage(message); return result; } }5.2 登录认证与 JWT 签发登录接口接收用户名、密码和验证码校验通过后使用 Hutool 工具生成 JWT Token并将用户基本信息存入 Redis 以便后续鉴权。Service public class AuthService { Autowired private SysUserMapper userMapper; Autowired private StringRedisTemplate redisTemplate; public ResultLoginResponse login(LoginRequest request) { // 校验图形验证码 String cacheCode redisTemplate.opsForValue().get(captcha: request.getUuid()); if (cacheCode null || !cacheCode.equalsIgnoreCase(request.getCode())) { return Result.error(验证码错误或已过期); } // 查询用户 SysUser user userMapper.selectOne( new LambdaQueryWrapperSysUser() .eq(SysUser::getUsername, request.getUsername())); if (user null) { return Result.error(用户不存在); } // 校验密码 if (!BCrypt.checkpw(request.getPassword(), user.getPassword())) { return Result.error(密码错误); } if (user.getStatus() 0) { return Result.error(账号已被停用); } // 生成 JWT String token JWT.create() .setJWTId(UUID.randomUUID().toString()) .setClaim(userId, user.getId()) .setClaim(username, user.getUsername()) .setExpiresAt(new Date(System.currentTimeMillis() 7200000)) .sign(Algorithm.HMAC256(your-secret-key)); LoginResponse response new LoginResponse(); response.setToken(token); response.setNickname(user.getNickname()); return Result.success(response); } }5.3 基于注解的权限校验系统通过自定义注解与 Spring AOP 实现按钮级权限控制。在需要鉴权的方法上标注 RequirePermission即可在方法执行前完成权限判断。Target(ElementType.METHOD) Retention(RetentionPolicy.RUNTIME) public interface RequirePermission { String value(); } Aspect Component public class PermissionAspect { Around(annotation(requirePermission)) public Object checkPermission(ProceedingJoinPoint joinPoint, RequirePermission requirePermission) throws Throwable { // 从 SecurityContext 获取当前登录用户 LoginUser loginUser (LoginUser) SecurityContextHolder .getContext().getAuthentication().getPrincipal(); // 获取用户权限集合 SetString permissions loginUser.getPermissions(); if (!permissions.contains(requirePermission.value())) { throw new BusinessException(无操作权限); } return joinPoint.proceed(); } }5.4 用户管理接口用户管理模块提供分页查询、新增用户和删除用户三个典型接口演示了 MyBatis-Plus 在后台管理场景中的常见用法。RestController RequestMapping(/api/user) public class SysUserController { Autowired private SysUserService userService; GetMapping(/page) public ResultPageSysUser page(RequestParam Integer pageNum, RequestParam Integer pageSize, RequestParam(required false) String keyword) { PageSysUser page userService.pageQuery(pageNum, pageSize, keyword); return Result.success(page); } PostMapping RequirePermission(system:user:add) public ResultVoid add(RequestBody SysUser user) { userService.addUser(user); return Result.success(null); } DeleteMapping(/{id}) RequirePermission(system:user:delete) public ResultVoid delete(PathVariable Long id) { userService.deleteUser(id); return Result.success(null); } }6. 系统测试与总结系统开发完成后针对登录认证、用户管理、角色授权等核心功能进行了接口测试与页面联调。测试结果表明各模块功能运行稳定权限拦截能够按预期生效接口响应时间满足日常管理场景的使用要求。本系统基于 Spring Boot 搭建了一套结构清晰、易于扩展的企业后台管理基础框架覆盖了认证授权、组织用户管理和通用业务支撑等核心能力。后续可以在此基础上继续扩展业务报表、消息通知、工作流审批等模块使系统更好地服务于企业实际运营需求。
1. 项目背景与意义随着企业信息化建设的不断深入传统的手工台账和单机办公模式已难以满足日常运营对效率、规范和数据安全的要求。越来越多的企业希望将人员管理、权限控制、业务数据维护等后台工作统一迁移到 Web 平台之上实现集中化、流程化和可追溯的管理。Spring Boot 作为当前 Java 生态中主流的微服务开发框架凭借自动配置、内嵌容器、起步依赖等特性大幅降低了企业级应用的搭建成本。基于 Spring Boot 开发企业后台管理系统既能够快速落地又保留了良好的扩展性和维护性是许多中小型企业在数字化转型过程中的务实选择。本课题的研究意义主要体现在以下三个方面提升管理效率将分散的线下流程线上化减少重复劳动提高数据流转速度。强化权限安全通过统一的认证与授权机制保障不同角色只能访问其职责范围内的功能与数据。沉淀可复用架构梳理出一套层次清晰、易于扩展的后台系统基础框架为后续业务模块的持续迭代提供支撑。2. 系统技术栈本系统采用前后端分离的开发模式后端以 Spring Boot 为核心前端使用 Vue 生态构建管理界面数据库选用 MySQL缓存与会话管理借助 Redis 完成。整体技术选型兼顾了开发效率、运行性能与社区生态的成熟度。层次技术选型主要作用后端框架Spring Boot 2.7提供自动配置、依赖管理与内嵌容器简化项目搭建持久层MyBatis-Plus简化单表 CRUD 操作内置分页与条件构造器安全认证Spring Security JWT实现登录认证、接口鉴权与无状态会话管理数据库MySQL 8.0存储用户、角色、菜单及业务数据缓存中间件Redis缓存验证码、用户 Token 与热点数据前端框架Vue 3 Element Plus构建后台管理界面与通用组件接口文档Knife4j自动生成在线接口文档便于前后端联调3. 系统功能模块设计企业后台管理系统通常围绕“用户—角色—权限—业务数据”这条主线进行设计。本系统在功能上划分为以下几个核心模块登录认证模块支持账号密码登录、图形验证码校验登录成功后签发 JWT Token。用户管理模块维护系统用户的基本信息支持新增、编辑、删除、重置密码与启用停用操作。角色管理模块维护角色信息并为角色分配菜单权限与数据权限。菜单管理模块以树形结构维护系统菜单与按钮权限标识动态生成前端路由。部门管理模块维护企业组织架构支持树形展示与层级查询。日志管理模块记录用户登录日志与操作日志便于安全审计与问题追溯。4. 数据库设计数据库设计遵循第三范式并结合实际查询场景进行适度冗余。核心表包括用户表、角色表、菜单表、用户角色关联表、角色菜单关联表以及部门表。CREATE TABLE sys_user ( id BIGINT AUTO_INCREMENT PRIMARY KEY, username VARCHAR(50) NOT NULL COMMENT 登录账号, password VARCHAR(100) NOT NULL COMMENT 加密密码, nickname VARCHAR(50) DEFAULT NULL COMMENT 显示名称, dept_id BIGINT DEFAULT NULL COMMENT 所属部门, status TINYINT DEFAULT 1 COMMENT 状态1启用 0停用, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, UNIQUE KEY uk_username (username) ) COMMENT 系统用户表; CREATE TABLE sys_role ( id BIGINT AUTO_INCREMENT PRIMARY KEY, role_name VARCHAR(50) NOT NULL COMMENT 角色名称, role_key VARCHAR(50) NOT NULL COMMENT 角色标识, status TINYINT DEFAULT 1 COMMENT 状态, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, UNIQUE KEY uk_role_key (role_key) ) COMMENT 系统角色表; CREATE TABLE sys_menu ( id BIGINT AUTO_INCREMENT PRIMARY KEY, parent_id BIGINT DEFAULT 0 COMMENT 父菜单ID, menu_name VARCHAR(50) NOT NULL COMMENT 菜单名称, menu_type CHAR(1) DEFAULT M COMMENT 类型M目录 C菜单 F按钮, path VARCHAR(200) DEFAULT NULL COMMENT 路由地址, perms VARCHAR(100) DEFAULT NULL COMMENT 权限标识, sort INT DEFAULT 0 COMMENT 排序, visible TINYINT DEFAULT 1 COMMENT 是否显示 ) COMMENT 系统菜单表; CREATE TABLE sys_user_role ( user_id BIGINT NOT NULL, role_id BIGINT NOT NULL, PRIMARY KEY (user_id, role_id) ) COMMENT 用户角色关联表; CREATE TABLE sys_role_menu ( role_id BIGINT NOT NULL, menu_id BIGINT NOT NULL, PRIMARY KEY (role_id, menu_id) ) COMMENT 角色菜单关联表;5. 核心代码实现本节选取登录认证、统一响应封装、权限校验和用户管理四个关键环节展示系统的核心实现思路。5.1 统一响应结果封装为保证前后端接口数据格式一致系统定义了统一的响应对象 Result所有控制器方法均返回该类型。Data public class ResultT { private Integer code; private String message; private T data; public static T ResultT success(T data) { ResultT result new Result(); result.setCode(200); result.setMessage(操作成功); result.setData(data); return result; } public static T ResultT error(String message) { ResultT result new Result(); result.setCode(500); result.setMessage(message); return result; } }5.2 登录认证与 JWT 签发登录接口接收用户名、密码和验证码校验通过后使用 Hutool 工具生成 JWT Token并将用户基本信息存入 Redis 以便后续鉴权。Service public class AuthService { Autowired private SysUserMapper userMapper; Autowired private StringRedisTemplate redisTemplate; public ResultLoginResponse login(LoginRequest request) { // 校验图形验证码 String cacheCode redisTemplate.opsForValue().get(captcha: request.getUuid()); if (cacheCode null || !cacheCode.equalsIgnoreCase(request.getCode())) { return Result.error(验证码错误或已过期); } // 查询用户 SysUser user userMapper.selectOne( new LambdaQueryWrapperSysUser() .eq(SysUser::getUsername, request.getUsername())); if (user null) { return Result.error(用户不存在); } // 校验密码 if (!BCrypt.checkpw(request.getPassword(), user.getPassword())) { return Result.error(密码错误); } if (user.getStatus() 0) { return Result.error(账号已被停用); } // 生成 JWT String token JWT.create() .setJWTId(UUID.randomUUID().toString()) .setClaim(userId, user.getId()) .setClaim(username, user.getUsername()) .setExpiresAt(new Date(System.currentTimeMillis() 7200000)) .sign(Algorithm.HMAC256(your-secret-key)); LoginResponse response new LoginResponse(); response.setToken(token); response.setNickname(user.getNickname()); return Result.success(response); } }5.3 基于注解的权限校验系统通过自定义注解与 Spring AOP 实现按钮级权限控制。在需要鉴权的方法上标注 RequirePermission即可在方法执行前完成权限判断。Target(ElementType.METHOD) Retention(RetentionPolicy.RUNTIME) public interface RequirePermission { String value(); } Aspect Component public class PermissionAspect { Around(annotation(requirePermission)) public Object checkPermission(ProceedingJoinPoint joinPoint, RequirePermission requirePermission) throws Throwable { // 从 SecurityContext 获取当前登录用户 LoginUser loginUser (LoginUser) SecurityContextHolder .getContext().getAuthentication().getPrincipal(); // 获取用户权限集合 SetString permissions loginUser.getPermissions(); if (!permissions.contains(requirePermission.value())) { throw new BusinessException(无操作权限); } return joinPoint.proceed(); } }5.4 用户管理接口用户管理模块提供分页查询、新增用户和删除用户三个典型接口演示了 MyBatis-Plus 在后台管理场景中的常见用法。RestController RequestMapping(/api/user) public class SysUserController { Autowired private SysUserService userService; GetMapping(/page) public ResultPageSysUser page(RequestParam Integer pageNum, RequestParam Integer pageSize, RequestParam(required false) String keyword) { PageSysUser page userService.pageQuery(pageNum, pageSize, keyword); return Result.success(page); } PostMapping RequirePermission(system:user:add) public ResultVoid add(RequestBody SysUser user) { userService.addUser(user); return Result.success(null); } DeleteMapping(/{id}) RequirePermission(system:user:delete) public ResultVoid delete(PathVariable Long id) { userService.deleteUser(id); return Result.success(null); } }6. 系统测试与总结系统开发完成后针对登录认证、用户管理、角色授权等核心功能进行了接口测试与页面联调。测试结果表明各模块功能运行稳定权限拦截能够按预期生效接口响应时间满足日常管理场景的使用要求。本系统基于 Spring Boot 搭建了一套结构清晰、易于扩展的企业后台管理基础框架覆盖了认证授权、组织用户管理和通用业务支撑等核心能力。后续可以在此基础上继续扩展业务报表、消息通知、工作流审批等模块使系统更好地服务于企业实际运营需求。
