📌 博主身份：本次实训图书管理系统项目组长——海瑞
📌 完成周期：实训第 3 周（已按期完成所有基础框架与权限核心模块）
📌 个人负责模块：
- 项目整体环境搭建 + SpringBoot+Vue 框架初始化
- 整合 Maven、Redis、MyBatis 全套底层环境
- 用户权限管理模块（管理员 / 读者 双角色区分）
- 全局工具类、异常处理、拦截器、权限校验、登录注册接口开发
- 全局跨域、启动报错、接口冲突排查与团队进度、文档、答辩统筹
本篇为本人实训第一篇技术博客，完整记录个人负责的核心代码实现、功能逻辑、关键配置、实战踩坑，所有代码均为项目落地可运行版本，同时附带功能讲解与可截图展示的功能点，适合实训总结、课程设计、毕设参考。
一、项目架构与本人负责整体逻辑
1.1 技术栈
后端：SpringBoot + Maven + MyBatis + Redis + SpringSecurity
前端：Vue2 + VueRouter + Axios
整体架构：标准前后端分离架构
1.2 本人核心开发工作概述
作为组长，我负责项目地基搭建 + 权限核心模块，是整个项目最基础、最核心的部分： - 搭建整套前后端分离框架，统一工程结构，为组员开发提供标准模板
- 封装项目全局统一返回结果、全局异常处理，统一项目接口风格
- 自定义拦截器 + SpringSecurity 实现管理员/读者角色权限拦截、菜单权限控制
- 完成登录、注册、权限校验核心接口
- 解决全局跨域、启动报错、Redis连接异常、团队接口冲突等疑难问题
二、核心代码实现（本人独立编写模块）
以下所有代码均为本人负责编写、调试、落地，属于本次实训个人独立工作内容。
2.1 项目统一返回结果工具类（全局通用）
为解决项目接口返回格式混乱问题，我手动封装 Result 统一返回工具类，全局所有接口统一格式输出，方便前端统一解析、统一弹窗提示。
/**
全局统一返回结果工具类
@author 海瑞（组长）
@date 实训第3周
*/
public class Result {
private Integer code; // 状态码
private String msg; // 提示信息
private Object data; // 返回数据// 成功返回
public static Result success(Object data){
Result r = new Result();
r.setCode(200);
r.setMsg(“请求成功”);
r.setData(data);
return r;
}// 失败返回
public static Result error(String msg){
Result r = new Result();
r.setCode(500);
r.setMsg(msg);
return r;
}// 权限不足返回
public static Result noAuth(){
Result r = new Result();
r.setCode(403);
r.setMsg(“权限不足，禁止访问”);
return r;
}// getter、setter 省略
}
2.2 全局统一异常处理类
本人搭建全局异常处理器，统一捕获系统异常、业务异常、权限异常，避免前端返回杂乱报错信息，提升项目稳定性。
/**全局异常统一处理
@author 海瑞（组长）
*/
@RestControllerAdvice
public class GlobalExceptionHandler {// 全局未知异常
@ExceptionHandler(Exception.class)
public Result error(Exception e){
e.printStackTrace();
return Result.error(“系统异常，请联系管理员”);
}// 权限异常拦截
@ExceptionHandler(AccessDeniedException.class)
public Result accessError(){
return Result.noAuth();
}
}
2.3 全局跨域配置类（解决前后端联调跨域问题）
项目初期最大问题就是前后端跨域，我独立编写全局跨域配置，彻底解决所有接口跨域报错，无需每个接口单独处理。
/**全局跨域配置
@author 海瑞（组长）
/
@Configuration
public class CorsConfig implements WebMvcConfigurer {
@Override
public void addCorsMappings(CorsRegistry registry) {
registry.addMapping(“/**”)
.allowedOriginPatterns("")
.allowCredentials(true)
.allowedMethods(“GET”,“POST”,“PUT”,“DELETE”)
.maxAge(3600);
}
}
2.4 自定义请求拦截器（权限拦截核心）
为实现管理员、读者角色区分，我开发自定义拦截器，对需要权限的接口进行统一拦截校验，实现基础权限控制逻辑。
/**自定义权限拦截器
@author 海瑞（组长）
*/
@Component
public class AuthInterceptor implements HandlerInterceptor {// 接口访问前置拦截
@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
// 1. 获取登录用户token、角色信息
// 2. 判断是否登录、是否有权限
// 3. 区分管理员/读者权限访问范围
String token = request.getHeader(“token”);
if(StringUtils.isEmpty(token)){
response.getWriter().write(JSON.toJSONString(Result.error(“未登录，请先登录”)));
return false;
}
// 后续结合Redis校验token、角色权限
return true;
}
}
2.5 用户登录、权限校验核心接口
本人独立开发登录接口，实现账号密码校验、Redis缓存登录信息、角色信息返回，为前端菜单权限渲染提供数据支撑。
/**登录、权限校验接口
@author 海瑞（组长）
*/
@RestController
@RequestMapping(“/user”)
public class UserController {@Autowired
private UserService userService;// 登录接口
@PostMapping(“/login”)
public Result login(@RequestBody User user){
// 校验账号密码
User loginUser = userService.login(user);
if(loginUser == null){
return Result.error(“账号或密码错误”);
}
// 生成token、存入Redis
String token = UUID.randomUUID().toString();
redisTemplate.opsForValue().set(token,loginUser,30, TimeUnit.MINUTES);
// 返回token与角色信息
Map<String,Object> map = new HashMap<>();
map.put(“token”,token);
map.put(“role”,loginUser.getRole());
return Result.success(map);
}// 权限校验接口
@GetMapping(“/checkAuth”)
public Result checkAuth(@RequestParam String role){
// 校验角色权限，区分管理员/读者
if(“admin”.equals(role) || “reader”.equals(role)){
return Result.success(“权限校验通过”);
}
return Result.noAuth();
}
}
三、核心功能逻辑讲解（本人实现业务逻辑）
3.1 多角色权限控制逻辑
我设计的权限逻辑流程：
- 用户登录成功后，后端根据账号返回对应角色（admin/reader）
- 后端将用户信息、角色信息存入 Redis，设置过期时间
- 前端存储 token，每次请求携带 token
- 全局拦截器拦截请求，校验 token 是否有效、用户角色权限
- 管理员：拥有用户管理、图书管理、权限管理全部菜单权限
- 读者：仅拥有图书查询、个人中心基础权限，无法进入后台管理模块
3.2 全局架构统一逻辑
通过我封装的 统一返回类 + 全局异常 + 全局跨域 + 统一拦截器，让整个项目：
- 接口风格统一、报错统一、权限校验统一
- 组员开发无需关注底层配置，只需要写业务代码
- 极大减少团队开发冲突、BUG率
四、可截图展示的核心功能点（适合博客配图）
以下为我负责模块可直接截图放到博客的功能页面，每一张都是本人开发落地功能：
7. 系统登录页面截图（本人开发登录接口对接）
8.
管理员登录后台首页截图（拥有全部菜单权限）
10.读者角色登录截图（菜单权限受限，验证权限拦截生效）
Redis缓存用户信息截图（验证登录缓存功能）
五、本人实战踩坑总结（全部亲自排查解决）
作为组长，我排查解决了项目所有底层核心问题：
- 坑1：前后端跨域报错 —— 解决方案：编写全局Cors配置类，彻底全局放行
- 坑2：项目启动报错、Maven依赖冲突 —— 统一依赖版本、清理冲突jar包
- 坑3：Redis连接失败 —— 修正配置、开启本地服务、关闭保护模式
- 坑4：角色权限403访问异常 —— 修正拦截器放行规则、区分角色权限
- 坑5：团队多人开发接口冲突 —— 统一接口前缀、统一命名规范、统筹分工
六、个人实训工作总结
本次实训第3周，我已100%完成个人负责全部模块：项目环境搭建、框架初始化、Maven/Redis/MyBatis整合、登录注册接口、双角色权限拦截、全局工具类、全局异常、跨域解决、团队接口协调、文档与PPT框架搭建。
作为组长，不仅完成个人开发任务，还负责项目进度管控、组员分工协调、整体文档汇总、答辩统筹，保障项目整体稳步推进。
