每年到毕业季后台私信问得最多的问题就是有没有适合新手写的SpringBootVue毕设项目前后端分离的项目跑不起来怎么办管理系统怎么做才不算烂大街说实话计算机毕业设计来来去去就那么几类管理系统而“工会管理系统”这个选题是我一直比较推荐的——业务边界清晰覆盖了增删改查、权限控制、文件导入导出、统计报表这些常见考点又不像电商系统那样到处是雷。这篇文章就把我做这套基于SpringBootVue的工会管理系统的完整过程拆开讲从数据库设计到前后端实现再到答辩前最容易翻车的地方一次性说清楚。这套系统能做什么先说人话版本它能管会员信息、收会费、发活动通知、记录活动报名和签到、维护工会组织架构还能给不同角色分配不同的菜单权限。别小看这套东西它几乎覆盖了企业内部信息系统最常见的所有操作形态。你用SpringBootVue把它做明白后面再去接触商城、OA、党建系统这类题目会发现大多数模块都是换汤不换药。适合谁参考一类是准备拿工会管理系统当毕设题目的学生照着我这个思路做能少走很多弯路另一类是报了培训班但只会跟着视频敲、不会独立设计项目的朋友这篇文章相当于帮你把项目的骨架和关键逻辑提前过了一遍。内容偏实战我会尽量把每一步为什么这么做的理由也写清楚不光是甩代码。1. 整体设计为什么选SpringBootVue为什么这样拆模块1.1 技术选型的理由SpringBoot不用多说Java后端写管理系统最顺手的方案之一内置Tomcat配置少能快速搭建REST接口。Vue负责前端双向绑定和组件化开发让页面维护起来很舒服。MySQL存业务数据。这套组合最大的优势不是“新”而是“稳”——教程多、社区资料全、踩坑答案一搜就有对时间紧张的毕业设计来说太重要了。选型的时候有几个版本问题要提前定好不然开发到一半再改非常痛苦。我用的是SpringBoot 2.7.x配JDK8ORM用MyBatis-Plus而不是原生MyBatis因为MyBatis-Plus自带单表增删改查和分页插件能把重复的SQL代码省掉一大半身份敏感的时间留给业务逻辑。如果你用的是JDK17以上可以上SpringBoot 3.x但要注意部分老依赖的兼容性改起来会比较折腾。数据库用MySQL 5.7或8.0都行8.0的话记得配好驱动和时区参数这个后面排错环节我会具体讲。鉴权方案我强烈建议用JWT加拦截器不要引Spring Security这种重量级框架。不是Spring Security不好而是毕设阶段你只需要登录认证和简单的角色权限判断用JWT就够了代码量小还容易在答辩时讲清楚。有人喜欢加上Redis存token做单点登录我只能说时间不够就别折腾先把核心功能跑通比什么都强。我发现很多人在毕业设计上翻车不是技术上多难而是把时间花在炫技上。比如非要用微服务、负载均衡、Redis缓存结果业务还没写完光服务间调用就调不明白。管理系统这种项目老老实实把SpringBootVue做扎实、把表设计好、把权限做通已经是一份很能拿出手的毕设了。1.2 功能模块怎么划分工会管理系统不要理解成“管会员的通讯录”。它真正的核心业务有几块组织架构管理。工会下面有分工会、工会小组是树形结构需要支持添加下级、调整上级。会员管理。入会、转出、退会、会员信息维护支持Excel批量导入导出是很大的加分项。会费管理。按周期收会费、记录流水、统计收缴率这是体现业务深度的模块。活动管理。活动发布、报名、签到、参与情况统计传播性和交互性最强。福利与慰问管理。节日福利发放记录、困难职工帮扶记录。系统管理。用户、角色、菜单、操作日志这是所有管理系统的地基。模块划分有一个经验不要试图把每个模块都做得大而全而是把其中两三个模块做出彩。比如把会员管理做成支持Excel导入导出、把活动报名做成带名额校验和签到状态、把系统管理做成真正的RBAC权限控制。这三点做出来答辩老师问起来你就能讲出花来。2. 数据库设计整个项目的根基2.1 核心表结构与设计思路数据库是整个系统的地基地基歪了后面做什么都难受。我的设计原则是尽量用通用型的表不要把业务字段靠拍脑袋硬堆。一旦表结构定下来后续改成本非常高所以宁可前期多花两天画ER图也不要写到一半才觉得字段不够用。我的表规划大概是这样表名作用sys_user登录账号表存用户名密码、状态sys_role角色表比如工会管理员、普通会员sys_menu菜单权限表目录、菜单、按钮权限都在这sys_user_role用户角色关联表sys_role_menu角色菜单关联表t_department部门/分工会表parent_id做树形结构t_member会员表存姓名、手机号、所属部门、状态等t_fee_record会费记录表缴费周期、金额、缴费时间t_activity活动表名称、时间、地点、人数上限t_activity_signup活动报名表活动id、会员id、签到状态为什么要把t_fee_record单独拆出来而不是在会员表里存一个“是否已缴费”的字段因为流水是独立的业务数据。你后面要做“某年度收缴率”的统计或者查某人历史缴费明细只有靠流水表才能算得准。很多同学在这里图省事结果做统计报表的时候把SQL写到怀疑人生。字段设计上金额一定要用decimal(10,2)别用float否则余额对不上你就知道有多痛了。每个表我建议都带这几个公共字段id主键BIGINT自增或者用MyBatis-Plus的雪花ID策略。create_time、update_time创建和更新时间。deleted逻辑删除标记0未删1已删。create_by创建人id留个审计线索。这里有个非常实用的技巧让MyBatis-Plus自动帮你填充create_time和update_time不要在业务代码里手动new Date()。你只需要在实体类字段上加TableField(fill FieldFill.INSERT)和TableField(fill FieldFill.INSERT_UPDATE)再写一个MetaObjectHandler实现类项目里所有表都能自动带时间戳。这套做法一次配置、处处受益省下的时间够你多写两个接口了。2.2 用户、角色、菜单三张表怎么串起来RBAC角色-权限模型是管理系统的灵魂。答辩老师最常问的问题之一就是你这个按钮级权限是怎么控制的所以这块必须吃透。简化版本是这么个流程用户登录后查出他的角色角色关联菜单菜单渲染成前端的路由和按钮。用户能看到什么页面、操作什么按钮都取决于角色绑定的菜单权限。sys_menu表里有个字段menu_type我习惯取三个值1目录、2菜单、3按钮。比如“会员管理”是菜单权限但里面的“新增会员”按钮是按钮权限。前端用自定义指令控制按钮显示或隐藏后端在新增、修改这些接口上做权限校验双保险。有同学问菜单表和权限表能不能合并可以毕设阶段你甚至可以就叫menu表但字段要设计好我给出一个参考idparent_id上级菜单id0表示根节点menu_name菜单名称menu_path前端路由路径perms权限标识比如member:addmenu_type1目录、2菜单、3按钮icon图标sort_order排序status启用状态后端在做权限校验的时候拿当前用户所拥有的perms集合去和接口要求的权限标识比对。比如你给新增会员接口标了RequiresPermission(member:add)那就看当前用户集合里有没有member:add这个字符串有就放行没有就返回无权限。3. SpringBoot后端的实现细节3.1 项目分包与公共类设计后端项目结构我建议这样做清晰、答辩也好讲com.example.union ├── config // 配置类跨域、MyBatis-Plus、拦截器注册 ├── controller // 控制器 ├── service // 业务层接口 ├── service.impl // 业务实现 ├── mapper // MyBatis-Plus Mapper ├── entity // 数据库实体 ├── dto // 接收前端的对象 ├── vo // 返回前端的结果对象 ├── common // 公共类Result、异常、常量 ├── utils // 工具类JwtUtil、ExcelUtil └── UnionApplication.java实体、DTO、VO分开是有讲究的。最核心的考虑是不要把数据库实体直接暴露给前端。比如会员实体有身份证号这种敏感字段列表接口完全不需要返回你可以做一个MemberVO只包含姓名、部门、手机号这些安全字段既安全又能减少接口传输量。这个设计思想在答辩时聊起来很加分。必须写一个统一返回体Result。我见过很多同学几百个接口每个返回格式都不一样前端接一个崩一个。统一返回体的代码非常简单就是一个泛型类加上code、msg、data三个字段。我给它提供了success和error两个静态方法一个返回成功一个返回失败全项目统一走这一套Data public class ResultT { private Integer code; private String msg; private T data; public static T ResultT success(T data) { ResultT result new Result(); result.setCode(200); result.setMsg(操作成功); result.setData(data); return result; } public static T ResultT error(Integer code, String msg) { ResultT result new Result(); result.setCode(code); result.setMsg(msg); return result; } }这个类看起来不起眼却是项目中价值最高的公共组件之一。你把统一返回体、全局异常处理器、JWT拦截器这三样弄好后面的业务代码就是流水线作业每天都能稳定产出好几个模块。另一个强烈建议的类是全局异常处理器用RestControllerAdvice捕获所有业务异常和兜底异常。否则后端某个接口报错前端拿到一坨Java异常堆栈既难看又不安全还会被老师质疑健壮性。3.2 登录认证与权限校验登录流程是这么走的用户提交用户名密码后端校验通过后生成一个JWT token返回给前端前端存在localStorage或者Pinia/Vuex里之后每次请求都在header里带上Authorization字段。为什么用JWT而不用Session因为前后端分离架构下前端可能跑在浏览器里也可能未来做App还要复用同一套接口。JWT是无状态的后端不需要存储会话信息非常适合这个场景。这个特点在答辩的时候可以展开讲你的前端和后端是独立部署的通过HTTP接口交互token相当于一张“临时身份证”后端每收到一次请求就验一次。生成token用jjwt库就行注意token里只存用户id和用户名别把密码放进去。登录成功后你可以把用户权限列表也一起返回给前端前端拿去生成菜单和按钮。拦截器里的核心逻辑是这样public class JwtInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { String authHeader request.getHeader(Authorization); if (authHeader null || !authHeader.startsWith(Bearer )) { throw new BusinessException(401, 未登录或登录已过期); } String token authHeader.substring(7); Claims claims JwtUtil.parseToken(token); request.setAttribute(userId, claims.get(userId)); return true; } }然后注册拦截器的时候要排除登录接口、文件预览接口、静态资源等白名单。这个细节特别容易坑如果你白名单配置不对前端刷新一下页面路由守卫触发接口请求却被拦截器挡回来了导致每次刷新都要重新登录。这一块多花点时间做仔细后面能省很多事。权限校验我建议用自定义注解加AOP切面的方式。先自定义一个注解Target({ElementType.METHOD, ElementType.TYPE}) Retention(RetentionPolicy.RUNTIME) public interface RequiresPermission { String value(); }然后在需要权限的接口上加RequiresPermission(member:add)用一个切面在方法执行前拿到当前用户的权限集合再和注解要求的权限比对。这个方案比在每个Controller里手动写权限判断要优雅得多代码可维护性也更高。答辩时老师看到你用了AOP会明显觉得你的设计是有层次的。3.3 核心接口与业务实现示例举一个最典型的例子会员分页查询。前端传pageNum、pageSize、keyword、departmentId后端返回分页结果。MyBatis-Plus的LambdaQueryWrapper可以把动态查询条件写得非常简洁GetMapping(/member/page) public ResultPageMemberVO page(RequestParam(defaultValue 1) Integer pageNum, RequestParam(defaultValue 10) Integer pageSize, String keyword, Long departmentId) { PageMember page new Page(pageNum, pageSize); LambdaQueryWrapperMember wrapper new LambdaQueryWrapper(); wrapper.like(StringUtils.hasText(keyword), Member::getMemberName, keyword) .eq(departmentId ! null, Member::getDepartmentId, departmentId) .orderByDesc(Member::getCreateTime); PageMember result memberService.page(page, wrapper); return Result.success(convertToVO(result)); }LambdaQueryWrapper最方便的地方是每个条件方法的第一个参数为false时自动跳过这个条件这样你就不用在代码里写一堆if判断。后端接口写得干净前端联调的时候也会很舒服。业务层里另一个典型场景是活动报名。报名之前要校验活动是否存在、报名是否截止、人数是否已满这就涉及事务了Transactional(rollbackFor Exception.class) public void signUp(Long activityId, Long userId) { Activity activity activityMapper.selectById(activityId); if (activity null || activity.getStatus() ! 1) { throw new BusinessException(活动不存在或未发布); } if (LocalDateTime.now().isAfter(activity.getSignUpDeadline())) { throw new BusinessException(报名已截止); } Long count signupMapper.selectCount(new LambdaQueryWrapperActivitySignup() .eq(ActivitySignup::getActivityId, activityId)); if (count activity.getMaxPeople()) { throw new BusinessException(该活动人数已满); } ActivitySignup signup new ActivitySignup(); signup.setActivityId(activityId); signup.setMemberId(userId); signup.setSignUpTime(LocalDateTime.now()); signup.setSignInStatus(0); signupMapper.insert(signup); }Transactional(rollbackFor Exception.class)会让这个业务操作成为一个整体插入报名记录之后如果还有什么步骤抛异常整条数据会回滚不会出现“报了名但数量不对”这种脏数据。事务回滚这个点也是答辩常客老师问“多个操作同时失败怎么办”你答上了就是加分项。Excel批量导入导出我建议用EasyExcel不要手写POI的循环。EasyExcel底层虽然也是POI但封装得好很多对内存友好还支持模型映射。导出代码基本就是这么几行EasyExcel.write(response.getOutputStream(), MemberExcelVO.class) .sheet(会员列表) .doWrite(dataList);注意导出接口和普通JSON接口不一样要额外设置响应头比如ContentType、文件名编码。这个细节我踩过坑浏览器下载下来的中文文件名直接乱码后来发现要URLEncoder.encode处理一遍。4. Vue前端实现要点4.1 项目搭建与目录结构前端我用的是Vue2加Element UI如果你用Vue3加Element Plus核心思路完全一样无非是写法从选项式API变成组合式API。毕业设计阶段我更推荐Vue2因为网上的教程数量多到你踩任何一个坑都能搜到答案而Vue3的部分问题搜出来的博客可能还是错的。关键目录结构src ├── api // 接口请求按模块拆分 ├── assets // 静态资源 ├── components // 公共组件 ├── router // 路由配置 动态路由 ├── store // Vuex状态管理登录信息、菜单权限 ├── utils // request.js、auth.js等 └── views // 页面这里有一个非常重要的经验把axios请求统一封装到utils/request.js里不要在页面组件里直接写axios.get。统一封装带来的最大好处是你只需要在请求拦截器里自动带上token在响应拦截器里统一处理业务code为401的情况以后新增几百个接口都不用重复处理这些逻辑。import axios from axios import { Message } from element-ui import { getToken } from /utils/auth const service axios.create({ baseURL: process.env.VUE_APP_BASE_API, timeout: 10000 }) service.interceptors.request.use(config { const token getToken() if (token) { config.headers[Authorization] Bearer token } return config }) service.interceptors.response.use( response { const res response.data if (res.code ! 200) { if (res.code 401) { // 清除登录态跳转登录页 } Message.error(res.msg || 请求出错) return Promise.reject(new Error(res.msg)) } return res }, error { Message.error(error.message) return Promise.reject(error) } )4.2 动态路由与菜单权限动态路由是前端权限控制的重点。用户登录后后端根据角色返回菜单列表前端把这个菜单列表递归生成路由并通过addRoutes动态挂载到路由实例上。这一步要在路由守卫router.beforeEach里做。流程是判断store里有没有用户信息没有就去请求用户信息并生成菜单如果路由还没生成就拉取菜单、调用addRoutes然后next()放行。这里特别容易写出死循环因为addRoutes之后再次触发了路由守卫你就需要一个标志位判断是否已经生成过路由我习惯在store里放一个isRoutesGenerated字段来标记。菜单树的渲染用Element UI的el-menu它支持router模式el-menu-item的index就是路由路径。多级菜单一定要用递归组件处理不能写死三层。写一个MenuTree组件自己调自己这样不管菜单套多少层都能正常渲染。动态路由带来的体验差别是非常明显的你用普通会员账号登录看到的是自己的菜单没有系统管理那一块和管理员登录看到的东西完全不同。这体现的正是RBAC权限控制在前端的落地老师演示的时候随便切两个账号出来项目水平一下就上来了。5. 核心页面与关键交互5.1 会员管理页面会员管理页是这套系统出镜率最高的页面也是毕业生觉得“没什么可写”但其实最值得打磨的页面。页面要素大概是搜索区关键字、部门下拉、状态、表格区多选、分页、操作栏、弹窗表单新增/编辑、导入导出按钮。搜索区做成分页查询条件表格上方放几个筛选控件新增和编辑共用一个弹窗Dialog内部放一个表单。Element UI的表格自带分页组件绑定好total、pageNum、pageSize三个变量就行。操作栏里放“编辑”“删除”两个按钮删除最好用Popconfirm二次确认不然用户手一抖就把数据删了。特别提醒一点表单校验别省。Element UI表单自带rules校验能把很多无效数据挡在提交之前。身份证号、手机号这些字段写一下正则校验当然这只是为了体验更重要的是让老师看到你有这个意识。身份证号的18位校验、手机号的11位校验都能在答辩时说两句。5.2 活动报名与签到活动列表页需要展示活动状态未发布、报名中、已截止、进行中。报名按钮在报名截止前且用户尚未报名时才显示签到按钮由工作人员在活动当天点击。这块如果全让前端判断会写出一堆复杂的v-if条件而且后端权限一变前端就跟着乱。更好的做法是后端在活动列表接口里直接返回每个活动当前用户是否已报名、是否可报名这些状态字段。后端算好状态前端只管展示写起来会舒服很多public ActivityVO detail(Long activityId, Long currentUserId) { ActivityVO vo ...; long count signupMapper.selectCount(new LambdaQueryWrapperActivitySignup() .eq(ActivitySignup::getActivityId, activityId)); vo.setSignUpCount(count); vo.setAlreadySignUp(count 0); vo.setCanSignUp(activity.getStatus() 1 LocalDateTime.now().isBefore(activity.getSignUpDeadline()) count activity.getMaxPeople()); return vo; }这个小设计看起来不起眼但能让前端少掉一大堆逻辑判断也是前后端协作里非常实用的一条经验不要把复杂的业务判断都压给前端。业务状态是后端定义的前端负责展示和交互就好。6. 部署与常见问题排查6.1 前后端打包部署流程后端打包用Maven。注意在pom.xml里配置好skipTests否则单元测试因为数据库环境连不上而失败打包也会跟着失败。命令很简单mvn clean package -DskipTests打包完会生成一个可执行的jar文件在服务器上装好JDK和MySQL运行java -jar union-system.jar --spring.profiles.activeprod前端打包之前先检查环境变量。VUE_APP_BASE_API如果是前端的接口地址部署到同一台服务器时可以用/api这种相对路径再由Nginx转发到后端端口。这是解决跨域最有效的方式而不是在后端代码里把CORS全放开。Nginx配置大概这样server { listen 80; location / { root /opt/union/dist; try_files $uri $uri/ /index.html; } location /api/ { proxy_pass http://localhost:8080; } }前端dist目录交给Nginx托管后端jar运行在8080端口数据库监听3306通信全部走Nginx代理这是最简单稳妥的部署方案。很多同学在自己电脑上跑得好好的一到服务器上就跨域、404、接口连不上基本都是Nginx转发没配明白。6.2 最容易翻车的几个坑数据库连接时区问题。MySQL8的url里要加serverTimezoneAsia/ShanghaiuseSSLfalse否则连接直接报错或者时间差8小时。跨域问题。开发环境用vue.config.js里的proxy代理就行不要在axios请求里写完整http://localhost:8080这种地址否则联调的时候CORS报错会让你烦死。端口被占用。启动SpringBoot时报Port 8080 was already in use先在命令行输入netstat -ano | findstr 8080看看哪个进程占着任务管理器结束掉或者干脆在application.yml里换一个端口。前端npm install卡住。多半是镜像源问题国内网络建议把registry切到淘宝镜像否则下载Element UI这种大包能等到怀疑人生。时间字段传参。前端传的是字符串后端实体用LocalDateTime接收需要在SpringMVC里配置日期转换器否则接口直接报400参数错误。MyBatis-Plus字段填充不生效。检查实体类有没有加TableField(fill FieldFill.INSERT)MetaObjectHandler实现类有没有被Spring管理。注意逻辑删除字段如果叫deletedMyBatis-Plus默认会把它当成逻辑删除字段处理避免重复配置。我把最常出现的几个问题整理成一个速查表你遇到问题先对照看看现象可能原因解决思路前端请求401token过期或没带上查看请求头有没有Authorization接口跨域报错开发环境没配proxyvue.config.js配置proxy代理返回中文乱码响应编码设置不对Controller设置produces和字符集Excel导出文件名乱码文件名编码问题URLEncoder.encode处理文件名分页数据不对没配MyBatis-Plus分页拦截器配置PaginationInnerInterceptor6.3 交付时的源码、数据库和文档毕设交付时学校通常要求三样东西源码、数据库、文档。源码方面我建议把项目里的无用代码删干净配置文件里不要出现本机的绝对路径数据库连接配置用application-dev.yml和application-prod.yml分开让老师能一眼看懂你的环境切换。数据库交付要给建库脚本和初始化数据建议在项目里准备一个sql文件夹放一份完整的初始化脚本包含建表语句和测试数据。别直接把本机的Navicat备份给别人那种文件版本不通用老师换个环境就导入不了。脚本里最好写上create database语句别人拿到之后执行一遍就能跑起来这种体验会给你加分很多。文档部分重点写三块需求分析、数据库设计、核心功能实现说明。答辩PPT里放一到两张ER图、一张系统架构图、几张页面截图就差不多了。最关键的是你自己对代码的理解老师很可能直接点开你项目里的某个文件让你解释逻辑。这时候你如果连自己写的代码在哪都不知道那前面所有准备都白费了。7. 几个值得做的扩展点如果时间和精力允许我建议给系统加两个低成本高回报的功能点。第一个是操作日志。用一个AOP切面拦截Controller方法把操作人、操作时间、操作内容、操作结果记录下来。代码量不大但这一步会让系统完整性提升一个大台阶。老师看到你有审计日志会认为你考虑到了企业级系统的数据安全需求这个点很容易在答辩时聊出深度。第二个是数据统计。在首页做一个Dashboard展示会员总数、本月新入会人数、本月活动数、会费收缴率几个指标再放一张近6个月的会费收缴趋势图。这种图表在后端一个聚合查询就能出来前端用ECharts半小时就能画好。但视觉冲击力很强演示的时候页面一打开就有数据看板比光秃秃的表格好看太多了。这两个扩展点有一个共同的逻辑它们不改变核心表结构不引入新框架却能极大提升系统的完成度和演示效果。毕设阶段最重要的不是堆功能而是让整个项目看起来完整、思考周全。我个人做了好几个前后端分离毕设项目之后最深的体会是能把SpringBootVue这样一套管理系统从头到尾独立完成的人哪怕项目不复杂基础一定不会差。这个工会管理系统的题目前前后后覆盖了设计表、写接口、写页面、权限控制、打包部署这条完整链路真的做下来你对整个Web开发的认知会有一个质的提升。最后再分享一个小经验拿到题目别急着敲代码先把表设计好把接口路径草拟出来再和前端页面一一对应这样整个开发周期会顺很多。我做的时候吃过不少“边写边改表”的亏——最典型的是会员表和收费记录表一开始没分开后面做统计功能的时候差点要重写一遍。如果你正打算做这个题目可以从数据库设计开始先把两张核心表画明白再往下写代码。