简介基于Spring Boot的校园志愿者管理系统毕业设计资料包面向计算机相关专业学生毕业设计、课程实训或项目实践也可供对JavaWeb开发感兴趣的自学者梳理完整项目流程。系统围绕志愿者服务场景设计覆盖志愿者注册、活动信息展示与在线报名、活动心得分享与评论收藏、公告信息、交流反馈、个人中心等功能模块并配有管理员端登录与后台管理逻辑能够清晰呈现前端页面、后端接口和数据库之间的协作关系。压缩包体量约90.75MB内部包含可运行的Spring Boot项目源码、毕业论文文档及演示视频其中论文可作为撰写思路参考视频便于快速了解系统操作流程源码则可直接导入开发环境二次扩展。目前已有556人学习/浏览适合需要从零搭建完整系统中台、补充毕业设计文档或熟悉前后台一体化实现的读者。1. 为什么校园志愿者管理系统值得当样本工程拆一遍第一次打开这份基于 SpringBoot 的校园志愿者管理系统源码时容易先入为主地把它当成一个“增删改查”练习。实际上志愿者注册、活动报名、心得发布、公告推送、交流反馈组成的不是五个独立页面而是一条完整业务闭环用户在活动页报名报名生成记录活动结束发布心得管理员在后台审核并推送公告。这条链路上任何一环的实现方式都直接影响答辩时“为什么这么设计”的回答深度。这份资源适合两类读者正在做 SpringBoot 毕设、需要一套能跑通且讲得清流程的同学以及想快速理解管理类系统模块与权限划分的初级开发。压缩包里的论文和演示视频建议最后看先把代码按业务顺序读一遍收获完全不同。2. 数据模型与权限边界五张核心表和拦截器如何撑起全部页面2.1 从页面结构反推模块边界系统首页把功能拆得很明确首页、活动信息、活动心得、公告信息、交流反馈、个人中心、后台管理。前四个是面向志愿者的访客功能个人中心是登录后的用户自服务入口后台管理只对管理员开放。在 SpringBoot 单体内这对应一组页面控制器加若干资源控制器角色区分通过用户表里的 role 字段完成而不是把工程拆成两个服务。URL 设计上我一般会把后台统一放在 /admin 前缀下前台页面直接放在 / 下。这样有两个直接好处权限拦截器可以用 addPathPatterns(/admin/**) 一把锁住后台所有接口答辩时解释模块划分也更直观。管理员登录时选择身份不是多此一举而是避免同一账号既是管理员又是志愿者时的权限歧义同时方便演示现场快速切换身份。2.2 核心表结构五张表覆盖用户、活动、报名、心得与公告志愿者、活动、报名、心得、公告这五类业务对应五张核心表。报名单独拆出来是因为它是多对多关系一个活动有多个志愿者一个志愿者可以参加多个活动单独建表还能记录报名时间和取消状态。心得表加 activity_id 关联活动是为了在心得页展示“这个心得来自哪场活动”。收藏与评论我按常见做法分别拆成 favorite、comment 两张表favorite 用 user_id 加 experience_id 做唯一约束comment 记录用户、心得、内容和时间结构比上面五张都简单。建库时统一使用 utf8mb4 字符集避免 emoji 和生僻字在内容字段里报错。表名上的反引号建议保留user 在部分 MySQL 版本里是高频词加上更安全。CREATE TABLE user ( id BIGINT AUTO_INCREMENT PRIMARY KEY, username VARCHAR(50) NOT NULL UNIQUE COMMENT 登录名, password VARCHAR(100) NOT NULL COMMENT BCrypt 密文, name VARCHAR(50) COMMENT 真实姓名, gender TINYINT DEFAULT 0 COMMENT 0未知 1男 2女, age INT COMMENT 年龄, email VARCHAR(100), phone VARCHAR(20), avatar VARCHAR(255) COMMENT 头像访问路径, role VARCHAR(20) DEFAULT USER COMMENT USER 或 ADMIN, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ); CREATE TABLE activity ( id BIGINT AUTO_INCREMENT PRIMARY KEY, name VARCHAR(100) NOT NULL, type VARCHAR(50) COMMENT 活动类型, activity_time DATETIME COMMENT 活动时间, max_people INT DEFAULT 30 COMMENT 人数上限, venue VARCHAR(200) COMMENT 活动场地, intro TEXT COMMENT 活动介绍, image VARCHAR(255) COMMENT 展示图, status TINYINT DEFAULT 0 COMMENT 0未开始 1进行中 2已结束, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ); CREATE TABLE signup ( id BIGINT AUTO_INCREMENT PRIMARY KEY, user_id BIGINT NOT NULL, activity_id BIGINT NOT NULL, status TINYINT DEFAULT 0 COMMENT 0已报名 1已取消 2已完成, signup_time DATETIME DEFAULT CURRENT_TIMESTAMP, UNIQUE KEY uk_user_activity (user_id, activity_id) ); CREATE TABLE experience ( id BIGINT AUTO_INCREMENT PRIMARY KEY, user_id BIGINT NOT NULL, activity_id BIGINT NOT NULL, type VARCHAR(50) COMMENT 活动类型, content TEXT COMMENT 心得分享内容, image VARCHAR(255), status TINYINT DEFAULT 0 COMMENT 0待审核 1已发布, publish_time DATETIME, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ); CREATE TABLE announcement ( id BIGINT AUTO_INCREMENT PRIMARY KEY, title VARCHAR(200) NOT NULL, content TEXT, create_time DATETIME DEFAULT CURRENT_TIMESTAMP );几个关键字段的取舍如下字段所属表设计说明roleuser控制前台与后台入口代码里建议写死 USER / ADMIN 字符串不要用中文当值statusactivity活动状态驱动前台能否报名已结束状态要同时关掉报名入口uk_user_activitysignup联合唯一索引数据库层兜底同一用户重复报名statusexperience心得先审后发避免未审核内容直接出现在前台phoneuser注册页出现手机号时后端要加正则校验避免乱填user 表的 role 字段是整套权限的基石拦截器里拿它与路径前缀做匹配。activity 表的 status 字段不只是展示用它同时控制报名接口是否放行。signup 表上的联合唯一索引值得重点讲它和代码里的 count 查询构成双重保险即使两个并发请求同时过掉校验数据库也会拒绝第二条相同组合的记录。2.3 后台权限拦截器角色判断与路径拦截不用 Spring Security 时最直接的做法是注册一个 HandlerInterceptor只拦 /admin 开头的路径。Session 里已经在登录时放入了 user 对象拦截器里校验 role 即可。public class AdminInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { User user (User) request.getSession().getAttribute(loginUser); if (user ! null ADMIN.equals(user.getRole())) { return true; } response.sendRedirect(request.getContextPath() /login?errornopermission); return false; } }注册拦截器Configuration public class WebConfig implements WebMvcConfigurer { Override public void addInterceptors(InterceptorRegistry registry) { registry.addInterceptor(new AdminInterceptor()) .addPathPatterns(/admin/**) .excludePathPatterns(/admin/login); } }这段配置有两个点最容易漏。excludePathPatterns 必须把登录页和登录接口放行否则管理员连后台登录入口都进不去sendRedirect 时要用 request.getContextPath() 拼前缀部署到二级目录时重定向才不会失效。role 的取值在注册接口里写死为 USER管理员账号一般在初始化 SQL 里插入两条数据要保证完全一致否则后台会一直提示无权限。3. 志愿者注册与活动报名从参数校验到幂等控制3.1 注册接口后端二次校验与用户名唯一性注册页面有用户名、密码、确认密码、姓名、年龄、邮箱、手机。前端校验负责提示体验后端必须再校验一次因为绕过页面直接调接口时前端规则完全不生效。常见写法是 Controller 里先做确认密码比对再做用户名唯一性查询。PostMapping(/register) public Result register(RequestBody RegisterDTO dto) { if (!StringUtils.hasText(dto.getUsername()) || !StringUtils.hasText(dto.getPassword())) { return Result.error(用户名和密码不能为空); } if (!dto.getPassword().equals(dto.getConfirmPassword())) { return Result.error(两次输入的密码不一致); } Long count userMapper.selectCount( new LambdaQueryWrapperUser() .eq(User::getUsername, dto.getUsername())); if (count 0) { return Result.error(用户名已被注册); } User user new User(); user.setUsername(dto.getUsername()); user.setPassword(new BCryptPasswordEncoder().encode(dto.getPassword())); user.setName(dto.getName()); user.setAge(dto.getAge()); user.setEmail(dto.getEmail()); user.setPhone(dto.getPhone()); user.setRole(USER); userMapper.insert(user); return Result.success(注册成功); }RegisterDTO 直接承接前端提交的 JSON省去逐个 getParameter 的样板代码。LambdaQueryWrapper 最终生成 where username ? 的 SQLselectCount 比 selectList 轻量。这里容易犯的错误是把 StringUtils.hasText 的条件写反导致空字符串被放行。手机上还应该做一次正则匹配例如^1[3-9]\\d{9}$否则垃圾数据会把统计报表撑乱。3.2 密码加密与登录会话BCrypt 和 Session 的配合方式注册时用 BCryptPasswordEncoder 加密登录时用 matches 方法做明文与密文的比对。BCrypt 每次生成的密文都不一样相同密码在不同账号下密文也不同这比固定盐的 MD5 安全得多。登录接口接收用户名、密码、角色三个参数。角色从页面下拉框传入而不是从数据库里直接读这样做的目的是让登录动作明确区分身份。PostMapping(/login) public Result login(RequestParam String username, RequestParam String password, RequestParam String role, HttpSession session) { User user userMapper.selectOne( new LambdaQueryWrapperUser().eq(User::getUsername, username)); if (user null || !new BCryptPasswordEncoder().matches(password, user.getPassword())) { return Result.error(用户名或密码错误); } if (!role.equals(user.getRole())) { return Result.error(所选角色与账号不匹配); } session.setAttribute(loginUser, user); return Result.success(登录成功); }selectOne 要求用户名唯一所以建表时 username 必须加 UNIQUE否则同名账号会抛 TooManyResultsException。matches 方法第一个参数是明文第二个是密文顺序反了会永远返回 false。登录成功后把整个 user 对象放进 Session后面报名、收藏、后台判断都从 Session 取当前用户省去每次查询数据库。3.3 活动报名状态、重复、人数三个条件逐项判断报名按钮在活动信息页志愿者登录后点击调用报名接口。后端要做四件事确认已登录、确认活动存在且未结束、确认这个用户没报过名、确认人数没到上限。判断顺序固定为登录状态到活动状态再到重复报名和人数因为 Session 为空时后续查询已经没有意义。PostMapping(/activity/{id}/signup) public Result signUp(PathVariable Long id, HttpSession session) { User user (User) session.getAttribute(loginUser); if (user null) { return Result.error(请先登录); } Activity activity activityMapper.selectById(id); if (activity null || activity.getStatus() 2) { return Result.error(活动不存在或已结束); } Long signed signupMapper.selectCount( new LambdaQueryWrapperSignup() .eq(Signup::getUserId, user.getId()) .eq(Signup::getActivityId, id) .eq(Signup::getStatus, 0)); if (signed 0) { return Result.error(请勿重复报名); } Long people signupMapper.selectCount( new LambdaQueryWrapperSignup() .eq(Signup::getActivityId, id) .eq(Signup::getStatus, 0)); if (people activity.getMaxPeople()) { return Result.error(活动人数已满); } Signup signup new Signup(); signup.setUserId(user.getId()); signup.setActivityId(id); signup.setStatus(0); signupMapper.insert(signup); return Result.success(报名成功); }校验顺序判定条件失败提示对应代码1session 中 loginUser 不为空请先登录user null2activity 不为空且 status ! 2活动不存在或已结束activity.getStatus() 23该用户没有 status0 的报名记录请勿重复报名signupMapper.selectCount4已报名人数小于 max_people活动人数已满people maxPeople第四步的人数统计用 selectCount 而不是 selectList因为只需要数量不需要完整记录。这套代码单独看没有毛病但如果两个志愿者同时点报名存在并发间隙两个请求都查到人数未满然后都执行 insert。这时候建表语句里的 uk_user_activity 联合唯一索引起作用数据库直接拒绝重复插入接口捕获 DuplicateKeyException 转成“请勿重复报名”即可。3.4 个人中心资料更新、收藏管理与头像上传个人中心的信息更新是对 user 表执行 updateById前端把当前数据回填到表单用户修改后整体提交。头像上传涉及文件存储常见做法是把本地磁盘目录做成访问路径这样图片不进入数据库库里只保存路径字符串。file: upload-path: D:/upload/ access-path: /files/**Override public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler(fileProperties.getAccessPath()) .addResourceLocations(file: fileProperties.getUploadPath()); }addResourceLocations 的值必须以 file: 开头目录末尾要有分隔符这两处不一致会导致上传成功后浏览器访问 404。我的收藏页本质是查询 favorite 表关联 experience 表删除收藏执行 favoriteMapper.delete 带 user_id 和 experience_id 条件即可不需要事务。4. 管理员后台活动发布、公告推送与反馈处理的关键实现4.1 活动发布与分页查询管理员进入后台后活动管理是最核心的模块。发布接口同时承担新增和编辑两个动作判断依据是 activity.id 是否为空。id 为空执行 insert否则执行 updateById。这种写法在企业项目里很常见一个 save 接口处理两种场景减少前端路由数量。PostMapping(/admin/activity/save) public Result saveActivity(RequestBody Activity activity, HttpSession session) { if (!isAdmin(session)) { return Result.error(无管理员权限); } if (activity.getId() null) { activity.setCreateTime(LocalDateTime.now()); activity.setStatus(0); activityMapper.insert(activity); } else { activityMapper.updateById(activity); } return Result.success(保存成功); }分页查询用 MyBatis-Plus 的 Page 对象构造参数是当前页和每页条数页码从 1 开始GetMapping(/admin/activity/page) public Result page(RequestParam int page, RequestParam int size, RequestParam(required false) String type) { PageActivity p new Page(page, size); LambdaQueryWrapperActivity wrapper new LambdaQueryWrapper(); if (StringUtils.hasText(type)) { wrapper.like(Activity::getType, type); } wrapper.orderByDesc(Activity::getCreateTime); activityMapper.selectPage(p, wrapper); return Result.success(p); }isAdmin 方法封装了 Session 判断逻辑避免在每个接口里重复写private boolean isAdmin(HttpSession session) { User user (User) session.getAttribute(loginUser); return user ! null ADMIN.equals(user.getRole()); }分页接口的返回对象里包含 records、total、current、size 四个字段前端表格组件直接绑定。type 参数用了 like 查询属于模糊匹配如果活动类型是精确枚举这里改成 eq 更合理可以避免输入“环”匹配到“环保”和“环境”两种情况。4.2 公告推送与交流反馈回复公告信息是管理员单向发布的内容前台只有查看权限表结构简单核心是插入和列表查询。交流反馈则是一个双向流程用户提交反馈记录 status0管理员回复后 status1。PostMapping(/admin/announcement/save) public Result saveAnnouncement(RequestBody Announcement announcement, HttpSession session) { if (!isAdmin(session)) { return Result.error(无管理员权限); } announcement.setCreateTime(LocalDateTime.now()); announcementMapper.insert(announcement); return Result.success(公告已发布); }反馈回复接口需要先按 id 查出原记录再把回复内容和状态一起更新PostMapping(/admin/feedback/reply) public Result reply(RequestParam Long id, RequestParam String reply, HttpSession session) { if (!isAdmin(session)) { return Result.error(无管理员权限); } Feedback feedback feedbackMapper.selectById(id); feedback.setReply(reply); feedback.setStatus(1); feedbackMapper.updateById(feedback); return Result.success(回复成功); }注意状态字段建议用数字枚举而不是字符串数字在数据库里占空间更小排序也更稳定。前端展示时再通过枚举字典翻译成“待回复 / 已回复”。4.3 心得审核与评论管理活动心得模块的用户操作是发布和查看管理员侧多一个审核动作。前台发布心得时默认状态为 0只有管理员在后台把状态改成 1 后内容才会出现在活动心得列表页。这个“先审后发”的思路在校园类系统里尤其重要志愿者发布的内容如果绕过审核直接展示出现违规信息时运营方要承担责任。后台功能对应请求路径权限要求活动新增 / 编辑POST /admin/activity/saveADMIN活动分页列表GET /admin/activity/pageADMIN发布公告POST /admin/announcement/saveADMIN回复交流反馈POST /admin/feedback/replyADMIN心得审核POST /admin/experience/auditADMIN评论管理DELETE /admin/comment/{id}ADMIN评论管理相对简单用户在心得的详情页发表评论后台只提供删除入口不提供编辑。因为评论是用户生成内容管理员编辑会产生“这个回复到底是管理员说的还是用户说的”的归属问题直接删除是更安全的操作。删除评论时如果评论表里有子回复需要先删除子记录再删父记录或者再加一个 parent_id 字段做递归查询毕设场景下做到一级评论就够用。5. 从源码到可运行配置文件、打包命令与四个高频排错5.1 本地运行三步建库、改 yml、启动拿到源码后按三步走。先在 MySQL 里执行项目附带的 .sql 脚本建库建表然后用 IDE 打开项目修改 application.yml 里的数据库账号密码最后运行启动类。也可以用命令打包运行mvn clean package -DskipTests 生成 jar再用 java -jar target/xxx.jar 启动。第一次建议在 IDE 里跑报错定位更方便。server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/volunteer?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driverurl 里最有必要强调的是 serverTimezoneAsia/Shanghai。现在主流 MySQL 驱动版本都要求显式指定时区不配置启动时会直接抛异常。5.2 四个高频报错与排查方向报错信息出现原因处理方式Access denied for user rootlocalhostyml 里的账号密码与本地 MySQL 不一致改成自己的用户名密码注意 root 默认只允许 localhost 连接The server time zone value is unrecognized数据库连接没有指定时区url 末尾追加 serverTimezoneAsia/ShanghaiPort 8080 was already in use本地 8080 端口被其他程序占用改 server.port 为 8081或杀掉占用进程Failed to configure a DataSource启动类没读到数据源配置检查 resources 目录下是否有 application.yml 且文件名拼写正确5.3 冒烟测试检查单验证核心业务闭环源码跑通后按下面顺序过一遍能覆盖系统八成核心逻辑注册一个新账号查看 user 表密码字段不是明文。分别注册 USER 和 ADMIN 两个角色账号用错角色登录应提示不匹配。管理员发布一个活动志愿者账号报名成功。同一志愿者再次报名应提示请勿重复报名。把活动 max_people 改成 1用第二个志愿者报名应提示活动人数已满。志愿者发布心得审核前前台不可见管理员审核后前台可见。用户提交交流反馈管理员回复后用户端能查到 reply 字段内容。第 5 项如果第二个账号仍然报名成功说明人数判断用的不是 selectCount 而是查了错误字段回到 3.3 节对照参数第 2 项如果角色不匹配还能进后台说明拦截器没有正确注册到 /admin/** 路径上。本文还有配套的精品资源点击获取 
长河君 · 2026/9/17 5:09:32 · 阅读 1.2k SpringBoot校园志愿者管理系统：数据模型与权限控制的完整实践
简介基于Spring Boot的校园志愿者管理系统毕业设计资料包面向计算机相关专业学生毕业设计、课程实训或项目实践也可供对JavaWeb开发感兴趣的自学者梳理完整项目流程。系统围绕志愿者服务场景设计覆盖志愿者注册、活动信息展示与在线报名、活动心得分享与评论收藏、公告信息、交流反馈、个人中心等功能模块并配有管理员端登录与后台管理逻辑能够清晰呈现前端页面、后端接口和数据库之间的协作关系。压缩包体量约90.75MB内部包含可运行的Spring Boot项目源码、毕业论文文档及演示视频其中论文可作为撰写思路参考视频便于快速了解系统操作流程源码则可直接导入开发环境二次扩展。目前已有556人学习/浏览适合需要从零搭建完整系统中台、补充毕业设计文档或熟悉前后台一体化实现的读者。1. 为什么校园志愿者管理系统值得当样本工程拆一遍第一次打开这份基于 SpringBoot 的校园志愿者管理系统源码时容易先入为主地把它当成一个“增删改查”练习。实际上志愿者注册、活动报名、心得发布、公告推送、交流反馈组成的不是五个独立页面而是一条完整业务闭环用户在活动页报名报名生成记录活动结束发布心得管理员在后台审核并推送公告。这条链路上任何一环的实现方式都直接影响答辩时“为什么这么设计”的回答深度。这份资源适合两类读者正在做 SpringBoot 毕设、需要一套能跑通且讲得清流程的同学以及想快速理解管理类系统模块与权限划分的初级开发。压缩包里的论文和演示视频建议最后看先把代码按业务顺序读一遍收获完全不同。2. 数据模型与权限边界五张核心表和拦截器如何撑起全部页面2.1 从页面结构反推模块边界系统首页把功能拆得很明确首页、活动信息、活动心得、公告信息、交流反馈、个人中心、后台管理。前四个是面向志愿者的访客功能个人中心是登录后的用户自服务入口后台管理只对管理员开放。在 SpringBoot 单体内这对应一组页面控制器加若干资源控制器角色区分通过用户表里的 role 字段完成而不是把工程拆成两个服务。URL 设计上我一般会把后台统一放在 /admin 前缀下前台页面直接放在 / 下。这样有两个直接好处权限拦截器可以用 addPathPatterns(/admin/**) 一把锁住后台所有接口答辩时解释模块划分也更直观。管理员登录时选择身份不是多此一举而是避免同一账号既是管理员又是志愿者时的权限歧义同时方便演示现场快速切换身份。2.2 核心表结构五张表覆盖用户、活动、报名、心得与公告志愿者、活动、报名、心得、公告这五类业务对应五张核心表。报名单独拆出来是因为它是多对多关系一个活动有多个志愿者一个志愿者可以参加多个活动单独建表还能记录报名时间和取消状态。心得表加 activity_id 关联活动是为了在心得页展示“这个心得来自哪场活动”。收藏与评论我按常见做法分别拆成 favorite、comment 两张表favorite 用 user_id 加 experience_id 做唯一约束comment 记录用户、心得、内容和时间结构比上面五张都简单。建库时统一使用 utf8mb4 字符集避免 emoji 和生僻字在内容字段里报错。表名上的反引号建议保留user 在部分 MySQL 版本里是高频词加上更安全。CREATE TABLE user ( id BIGINT AUTO_INCREMENT PRIMARY KEY, username VARCHAR(50) NOT NULL UNIQUE COMMENT 登录名, password VARCHAR(100) NOT NULL COMMENT BCrypt 密文, name VARCHAR(50) COMMENT 真实姓名, gender TINYINT DEFAULT 0 COMMENT 0未知 1男 2女, age INT COMMENT 年龄, email VARCHAR(100), phone VARCHAR(20), avatar VARCHAR(255) COMMENT 头像访问路径, role VARCHAR(20) DEFAULT USER COMMENT USER 或 ADMIN, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ); CREATE TABLE activity ( id BIGINT AUTO_INCREMENT PRIMARY KEY, name VARCHAR(100) NOT NULL, type VARCHAR(50) COMMENT 活动类型, activity_time DATETIME COMMENT 活动时间, max_people INT DEFAULT 30 COMMENT 人数上限, venue VARCHAR(200) COMMENT 活动场地, intro TEXT COMMENT 活动介绍, image VARCHAR(255) COMMENT 展示图, status TINYINT DEFAULT 0 COMMENT 0未开始 1进行中 2已结束, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ); CREATE TABLE signup ( id BIGINT AUTO_INCREMENT PRIMARY KEY, user_id BIGINT NOT NULL, activity_id BIGINT NOT NULL, status TINYINT DEFAULT 0 COMMENT 0已报名 1已取消 2已完成, signup_time DATETIME DEFAULT CURRENT_TIMESTAMP, UNIQUE KEY uk_user_activity (user_id, activity_id) ); CREATE TABLE experience ( id BIGINT AUTO_INCREMENT PRIMARY KEY, user_id BIGINT NOT NULL, activity_id BIGINT NOT NULL, type VARCHAR(50) COMMENT 活动类型, content TEXT COMMENT 心得分享内容, image VARCHAR(255), status TINYINT DEFAULT 0 COMMENT 0待审核 1已发布, publish_time DATETIME, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ); CREATE TABLE announcement ( id BIGINT AUTO_INCREMENT PRIMARY KEY, title VARCHAR(200) NOT NULL, content TEXT, create_time DATETIME DEFAULT CURRENT_TIMESTAMP );几个关键字段的取舍如下字段所属表设计说明roleuser控制前台与后台入口代码里建议写死 USER / ADMIN 字符串不要用中文当值statusactivity活动状态驱动前台能否报名已结束状态要同时关掉报名入口uk_user_activitysignup联合唯一索引数据库层兜底同一用户重复报名statusexperience心得先审后发避免未审核内容直接出现在前台phoneuser注册页出现手机号时后端要加正则校验避免乱填user 表的 role 字段是整套权限的基石拦截器里拿它与路径前缀做匹配。activity 表的 status 字段不只是展示用它同时控制报名接口是否放行。signup 表上的联合唯一索引值得重点讲它和代码里的 count 查询构成双重保险即使两个并发请求同时过掉校验数据库也会拒绝第二条相同组合的记录。2.3 后台权限拦截器角色判断与路径拦截不用 Spring Security 时最直接的做法是注册一个 HandlerInterceptor只拦 /admin 开头的路径。Session 里已经在登录时放入了 user 对象拦截器里校验 role 即可。public class AdminInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { User user (User) request.getSession().getAttribute(loginUser); if (user ! null ADMIN.equals(user.getRole())) { return true; } response.sendRedirect(request.getContextPath() /login?errornopermission); return false; } }注册拦截器Configuration public class WebConfig implements WebMvcConfigurer { Override public void addInterceptors(InterceptorRegistry registry) { registry.addInterceptor(new AdminInterceptor()) .addPathPatterns(/admin/**) .excludePathPatterns(/admin/login); } }这段配置有两个点最容易漏。excludePathPatterns 必须把登录页和登录接口放行否则管理员连后台登录入口都进不去sendRedirect 时要用 request.getContextPath() 拼前缀部署到二级目录时重定向才不会失效。role 的取值在注册接口里写死为 USER管理员账号一般在初始化 SQL 里插入两条数据要保证完全一致否则后台会一直提示无权限。3. 志愿者注册与活动报名从参数校验到幂等控制3.1 注册接口后端二次校验与用户名唯一性注册页面有用户名、密码、确认密码、姓名、年龄、邮箱、手机。前端校验负责提示体验后端必须再校验一次因为绕过页面直接调接口时前端规则完全不生效。常见写法是 Controller 里先做确认密码比对再做用户名唯一性查询。PostMapping(/register) public Result register(RequestBody RegisterDTO dto) { if (!StringUtils.hasText(dto.getUsername()) || !StringUtils.hasText(dto.getPassword())) { return Result.error(用户名和密码不能为空); } if (!dto.getPassword().equals(dto.getConfirmPassword())) { return Result.error(两次输入的密码不一致); } Long count userMapper.selectCount( new LambdaQueryWrapperUser() .eq(User::getUsername, dto.getUsername())); if (count 0) { return Result.error(用户名已被注册); } User user new User(); user.setUsername(dto.getUsername()); user.setPassword(new BCryptPasswordEncoder().encode(dto.getPassword())); user.setName(dto.getName()); user.setAge(dto.getAge()); user.setEmail(dto.getEmail()); user.setPhone(dto.getPhone()); user.setRole(USER); userMapper.insert(user); return Result.success(注册成功); }RegisterDTO 直接承接前端提交的 JSON省去逐个 getParameter 的样板代码。LambdaQueryWrapper 最终生成 where username ? 的 SQLselectCount 比 selectList 轻量。这里容易犯的错误是把 StringUtils.hasText 的条件写反导致空字符串被放行。手机上还应该做一次正则匹配例如^1[3-9]\\d{9}$否则垃圾数据会把统计报表撑乱。3.2 密码加密与登录会话BCrypt 和 Session 的配合方式注册时用 BCryptPasswordEncoder 加密登录时用 matches 方法做明文与密文的比对。BCrypt 每次生成的密文都不一样相同密码在不同账号下密文也不同这比固定盐的 MD5 安全得多。登录接口接收用户名、密码、角色三个参数。角色从页面下拉框传入而不是从数据库里直接读这样做的目的是让登录动作明确区分身份。PostMapping(/login) public Result login(RequestParam String username, RequestParam String password, RequestParam String role, HttpSession session) { User user userMapper.selectOne( new LambdaQueryWrapperUser().eq(User::getUsername, username)); if (user null || !new BCryptPasswordEncoder().matches(password, user.getPassword())) { return Result.error(用户名或密码错误); } if (!role.equals(user.getRole())) { return Result.error(所选角色与账号不匹配); } session.setAttribute(loginUser, user); return Result.success(登录成功); }selectOne 要求用户名唯一所以建表时 username 必须加 UNIQUE否则同名账号会抛 TooManyResultsException。matches 方法第一个参数是明文第二个是密文顺序反了会永远返回 false。登录成功后把整个 user 对象放进 Session后面报名、收藏、后台判断都从 Session 取当前用户省去每次查询数据库。3.3 活动报名状态、重复、人数三个条件逐项判断报名按钮在活动信息页志愿者登录后点击调用报名接口。后端要做四件事确认已登录、确认活动存在且未结束、确认这个用户没报过名、确认人数没到上限。判断顺序固定为登录状态到活动状态再到重复报名和人数因为 Session 为空时后续查询已经没有意义。PostMapping(/activity/{id}/signup) public Result signUp(PathVariable Long id, HttpSession session) { User user (User) session.getAttribute(loginUser); if (user null) { return Result.error(请先登录); } Activity activity activityMapper.selectById(id); if (activity null || activity.getStatus() 2) { return Result.error(活动不存在或已结束); } Long signed signupMapper.selectCount( new LambdaQueryWrapperSignup() .eq(Signup::getUserId, user.getId()) .eq(Signup::getActivityId, id) .eq(Signup::getStatus, 0)); if (signed 0) { return Result.error(请勿重复报名); } Long people signupMapper.selectCount( new LambdaQueryWrapperSignup() .eq(Signup::getActivityId, id) .eq(Signup::getStatus, 0)); if (people activity.getMaxPeople()) { return Result.error(活动人数已满); } Signup signup new Signup(); signup.setUserId(user.getId()); signup.setActivityId(id); signup.setStatus(0); signupMapper.insert(signup); return Result.success(报名成功); }校验顺序判定条件失败提示对应代码1session 中 loginUser 不为空请先登录user null2activity 不为空且 status ! 2活动不存在或已结束activity.getStatus() 23该用户没有 status0 的报名记录请勿重复报名signupMapper.selectCount4已报名人数小于 max_people活动人数已满people maxPeople第四步的人数统计用 selectCount 而不是 selectList因为只需要数量不需要完整记录。这套代码单独看没有毛病但如果两个志愿者同时点报名存在并发间隙两个请求都查到人数未满然后都执行 insert。这时候建表语句里的 uk_user_activity 联合唯一索引起作用数据库直接拒绝重复插入接口捕获 DuplicateKeyException 转成“请勿重复报名”即可。3.4 个人中心资料更新、收藏管理与头像上传个人中心的信息更新是对 user 表执行 updateById前端把当前数据回填到表单用户修改后整体提交。头像上传涉及文件存储常见做法是把本地磁盘目录做成访问路径这样图片不进入数据库库里只保存路径字符串。file: upload-path: D:/upload/ access-path: /files/**Override public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler(fileProperties.getAccessPath()) .addResourceLocations(file: fileProperties.getUploadPath()); }addResourceLocations 的值必须以 file: 开头目录末尾要有分隔符这两处不一致会导致上传成功后浏览器访问 404。我的收藏页本质是查询 favorite 表关联 experience 表删除收藏执行 favoriteMapper.delete 带 user_id 和 experience_id 条件即可不需要事务。4. 管理员后台活动发布、公告推送与反馈处理的关键实现4.1 活动发布与分页查询管理员进入后台后活动管理是最核心的模块。发布接口同时承担新增和编辑两个动作判断依据是 activity.id 是否为空。id 为空执行 insert否则执行 updateById。这种写法在企业项目里很常见一个 save 接口处理两种场景减少前端路由数量。PostMapping(/admin/activity/save) public Result saveActivity(RequestBody Activity activity, HttpSession session) { if (!isAdmin(session)) { return Result.error(无管理员权限); } if (activity.getId() null) { activity.setCreateTime(LocalDateTime.now()); activity.setStatus(0); activityMapper.insert(activity); } else { activityMapper.updateById(activity); } return Result.success(保存成功); }分页查询用 MyBatis-Plus 的 Page 对象构造参数是当前页和每页条数页码从 1 开始GetMapping(/admin/activity/page) public Result page(RequestParam int page, RequestParam int size, RequestParam(required false) String type) { PageActivity p new Page(page, size); LambdaQueryWrapperActivity wrapper new LambdaQueryWrapper(); if (StringUtils.hasText(type)) { wrapper.like(Activity::getType, type); } wrapper.orderByDesc(Activity::getCreateTime); activityMapper.selectPage(p, wrapper); return Result.success(p); }isAdmin 方法封装了 Session 判断逻辑避免在每个接口里重复写private boolean isAdmin(HttpSession session) { User user (User) session.getAttribute(loginUser); return user ! null ADMIN.equals(user.getRole()); }分页接口的返回对象里包含 records、total、current、size 四个字段前端表格组件直接绑定。type 参数用了 like 查询属于模糊匹配如果活动类型是精确枚举这里改成 eq 更合理可以避免输入“环”匹配到“环保”和“环境”两种情况。4.2 公告推送与交流反馈回复公告信息是管理员单向发布的内容前台只有查看权限表结构简单核心是插入和列表查询。交流反馈则是一个双向流程用户提交反馈记录 status0管理员回复后 status1。PostMapping(/admin/announcement/save) public Result saveAnnouncement(RequestBody Announcement announcement, HttpSession session) { if (!isAdmin(session)) { return Result.error(无管理员权限); } announcement.setCreateTime(LocalDateTime.now()); announcementMapper.insert(announcement); return Result.success(公告已发布); }反馈回复接口需要先按 id 查出原记录再把回复内容和状态一起更新PostMapping(/admin/feedback/reply) public Result reply(RequestParam Long id, RequestParam String reply, HttpSession session) { if (!isAdmin(session)) { return Result.error(无管理员权限); } Feedback feedback feedbackMapper.selectById(id); feedback.setReply(reply); feedback.setStatus(1); feedbackMapper.updateById(feedback); return Result.success(回复成功); }注意状态字段建议用数字枚举而不是字符串数字在数据库里占空间更小排序也更稳定。前端展示时再通过枚举字典翻译成“待回复 / 已回复”。4.3 心得审核与评论管理活动心得模块的用户操作是发布和查看管理员侧多一个审核动作。前台发布心得时默认状态为 0只有管理员在后台把状态改成 1 后内容才会出现在活动心得列表页。这个“先审后发”的思路在校园类系统里尤其重要志愿者发布的内容如果绕过审核直接展示出现违规信息时运营方要承担责任。后台功能对应请求路径权限要求活动新增 / 编辑POST /admin/activity/saveADMIN活动分页列表GET /admin/activity/pageADMIN发布公告POST /admin/announcement/saveADMIN回复交流反馈POST /admin/feedback/replyADMIN心得审核POST /admin/experience/auditADMIN评论管理DELETE /admin/comment/{id}ADMIN评论管理相对简单用户在心得的详情页发表评论后台只提供删除入口不提供编辑。因为评论是用户生成内容管理员编辑会产生“这个回复到底是管理员说的还是用户说的”的归属问题直接删除是更安全的操作。删除评论时如果评论表里有子回复需要先删除子记录再删父记录或者再加一个 parent_id 字段做递归查询毕设场景下做到一级评论就够用。5. 从源码到可运行配置文件、打包命令与四个高频排错5.1 本地运行三步建库、改 yml、启动拿到源码后按三步走。先在 MySQL 里执行项目附带的 .sql 脚本建库建表然后用 IDE 打开项目修改 application.yml 里的数据库账号密码最后运行启动类。也可以用命令打包运行mvn clean package -DskipTests 生成 jar再用 java -jar target/xxx.jar 启动。第一次建议在 IDE 里跑报错定位更方便。server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/volunteer?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driverurl 里最有必要强调的是 serverTimezoneAsia/Shanghai。现在主流 MySQL 驱动版本都要求显式指定时区不配置启动时会直接抛异常。5.2 四个高频报错与排查方向报错信息出现原因处理方式Access denied for user rootlocalhostyml 里的账号密码与本地 MySQL 不一致改成自己的用户名密码注意 root 默认只允许 localhost 连接The server time zone value is unrecognized数据库连接没有指定时区url 末尾追加 serverTimezoneAsia/ShanghaiPort 8080 was already in use本地 8080 端口被其他程序占用改 server.port 为 8081或杀掉占用进程Failed to configure a DataSource启动类没读到数据源配置检查 resources 目录下是否有 application.yml 且文件名拼写正确5.3 冒烟测试检查单验证核心业务闭环源码跑通后按下面顺序过一遍能覆盖系统八成核心逻辑注册一个新账号查看 user 表密码字段不是明文。分别注册 USER 和 ADMIN 两个角色账号用错角色登录应提示不匹配。管理员发布一个活动志愿者账号报名成功。同一志愿者再次报名应提示请勿重复报名。把活动 max_people 改成 1用第二个志愿者报名应提示活动人数已满。志愿者发布心得审核前前台不可见管理员审核后前台可见。用户提交交流反馈管理员回复后用户端能查到 reply 字段内容。第 5 项如果第二个账号仍然报名成功说明人数判断用的不是 selectCount 而是查了错误字段回到 3.3 节对照参数第 2 项如果角色不匹配还能进后台说明拦截器没有正确注册到 /admin/** 路径上。本文还有配套的精品资源点击获取