前几天有学生想找一套能拿得出手的Java毕设项目问我有没有功能完整但又不太复杂的推荐。我把维护了半年的这套SpringBootVue日常办公用品直售推荐系统管理平台源码翻出来整理了一遍发现它其实是很好的样板后端就是JavaMySQL前端Vue典型的前后端分离结构但业务完整度比网上一堆图书管理系统高出不少尤其是直售和推荐两个点既有业务故事也有技术含量。这套系统简单来说就是做一个面向企业内部行政采购场景的办公用品商城商品由供应商直接入驻挂售员工在前端浏览、搜索、加购、下单后台管理端处理商品、订单、库存和用户。它不是一个只演示CRUD的玩具项目而是把登录鉴权、商品检索、购物车、订单状态机、库存扣减、推荐位展示这些电商核心链路都走了一遍。如果你是准备毕设、课设或者想通过一个完整项目把SpringBootVue、MySQL这些技能串起来的人这套源码非常合适拿来二次开发和改造。接下来我会从设计思路、数据模型、前后端实现、踩坑记录、升级方向这几个角度把这套系统的里里外外讲透。文章里提到的代码思路和表结构设计都是我在实际跑通这个项目的过程中验证过的方案你可以直接照着改。1. 项目定位与整体设计思路1.1 一个直售推荐的小型电商平台到底解决什么问题先说业务背景。传统办公用品采购普遍存在两个痛点第一行政采购一般要经过经销商、分销商层层加价价格不透明第二采购负责人凭经验选品员工真正需要什么、各部门消耗什么数据是缺失的。这套系统把直售和推荐作为两个核心卖点正好对着这两个痛点。直售体现在业务设计上供应商可以直接在平台挂商品、维护直售价跳过分销环节采购方看到的是厂商直供价。推荐体现在用户端平台根据员工的浏览记录、历史采购、部门属性在首页推荐位和商品详情页推荐相关办公用品让员工少翻几页就能找到需要的耗材。不要把推荐想得多高深。在数据量有限的毕设/课设场景里一个基于规则的热销推荐、新品推荐、部门偏好推荐就足够撑起业务故事了。真去上协同过滤、用户画像那套反而会因为数据稀疏跑不出效果。这一点我在后面会展开说。1.2 技术栈选型为什么是SpringBootVueMySQL很多人在选技术栈时纠结怕太简单被答辩老师问住又怕太复杂完不成。这套组合是我认为最平衡的方案理由有三点。第一SpringBoot是Java生态里目前最主流的快速开发框架内置Tomcat、自动配置、起步依赖管理把以前SpringMVC那套繁琐的XML配置全部干掉。一个毕业设计用SpringBoot不会被质疑技术老旧还能把精力集中在业务实现上。相比SSMSpringBoot的项目结构和配置明显更适合新手跑通。第二Vue在前端领域上手曲线平滑组件化思路和中文文档都比较友好。配合Element UI或Element Plus后台管理界面半天就能搭出来。Vue的响应式数据和路由管理做商品列表、购物车、后台表单这类交互足够。第三MySQL是教学和中小型项目最常用的关系型数据库事务支持完善工具链成熟。对于订单、库存、用户这类强一致性数据MySQL比NoSQL更合适。而且毕设答辩时MySQL的表设计和SQL优化是老师最容易提问的点多写一些有业务含义的SQL反而能成为加分项。相比之下如果你选Python写、前后端不分离、或者用SQLite项目体感和完工程度就会差很多。这套组合不是最炫的但是一个能说清楚、能跑起来、能扩展的组合。1.3 前端工程与后端工程的目录规划实际开发这套项目时我把代码分成两个独立工程后端office-supply-server前端office-supply-web。前后端分离通过RESTful接口通信。分工程的最大好处是部署职责清晰、开发和调试互不干扰答辩时也能单独讲清楚每一层的职责。后端采用经典分层结构controller接收请求、service处理业务逻辑、mapper与数据库交互、entity对应表结构。项目里我会额外加一个common包放统一返回结果类Result、异常处理器、JWT工具类、全局配置类。这样代码组织非常规整新手照着这个结构写不会出现一个Controller写300行的情况。前端我使用Vue CLI现在用Vite也行创建项目目录上比较重要的是api目录统一封装Axios请求views目录放页面级组件router目录配置路由表components目录放复用组件store目录用Pinia或Vuex管理全局用户状态。后面我会专门讲前端联调时的接口约定。2. 核心模块拆解与数据模型设计2.1 功能模块地图这套系统按角色可以分成三个端员工端、管理端、供应商端。员工端是普通员工使用的商城前台管理端是运营人员使用的后台管理系统。员工端主要功能包括注册登录、首页推荐位展示、商品分类浏览、关键词搜索、商品详情查看、加入购物车、购物车结算、订单列表与订单详情、取消订单确认收货、个人资料修改。这些功能覆盖了一个电商C端的基本闭环。管理端主要功能包括仪表盘数据统计、商品管理上架下架、库存调整、直售价维护、分类管理、订单管理发货、售后状态处理、用户管理、供应商管理和推荐位配置。管理端不追求花哨但每个按钮都要真实操作到数据库不是摆设。供应商端我简化成管理后台里的一个角色没有单独做前台但表结构上预留了supplier表。后续如果你想扩展供应商独立登录、供应商订单看板只需要新增一套Controller和页面即可不影响已有结构。推荐模块是这套系统的差异化亮点。我采用的方案是首页推荐位由后台配置可设置热销商品新品上架部门偏好猜你喜欢三种推荐策略。热销按销量排序新品按上架时间排序部门偏好则根据当前登录用户所属部门的购买记录来推送同类商品。这个方案数据量小、逻辑直观、效果可控答辩也能讲得清楚。2.2 数据库表结构设计数据库是整个系统最容易出彩也最容易翻车的地方。我建表的原则是核心业务表尽量精简字段只保留必须的但状态字段和关联字段不能省。这套系统我实际用了七张核心表加两张辅助表。用户表sys_user主键id、用户名、密码MD5加密存储实践中建议BCrypt、昵称、手机号、部门id、角色标识1员工/2管理员/3供应商、状态、创建时间。部门信息我单独用dept表保存不做冗余字段。商品表product主键id、商品名称、商品图片URL、分类id、供应商id、直售价price、原价market_price、库存stock、销量sales、上下架状态status、推荐权重recommend_weight、创建时间。这里直售价字段是直售业务的落地点管理端维护它商品列表展示它下单时读取它。订单表order和订单明细表order_item订单表maintain订单编号、用户id、总金额、订单状态0待付款/1待发货/2待收货/3已完成/4已取消、收货地址、创建时间订单明细表存商品id、购买数量、下单单价、小计金额。一单多品是电商基本形态必须拆明细表。购物车表cart用户id、商品id、数量、加入时间联合唯一索引。管理端配置表recommend_config推荐位标识、推荐标题、排序、状态、生效时间后台设置的推荐策略都存在这里。需要特别注意索引设计。实际项目里product表的分类id和上下架状态要建索引order表的用户id要建索引order_item表的订单id要建索引。索引不是越多越好但高频查询条件上的索引必须有否则数据量一上来联表查询就会明显变慢。学生项目容易被忽略的点反而是面试和答辩时能被追问的重点。2.3 直售与推荐业务的数据落地直售不只是页面上一个说法我在数据库里是真做了字段支撑的。商品表里的price和market_price就是直售业务的体现market_price是市场参考价price是供应商直售价前端商品卡片上会同时展示两个价格划掉原价、突出直售价这样去中间商的业务概念在界面上就是看得见的。数据初始化时我也刻意造了一批真实感的办公用品数据A4复印纸、中性笔、订书机、档案盒、硒鼓、键盘、显示器支架等。每个商品设置不同的销量和上架时间让推荐模块一跑起来就有区分度。推荐业务的落点在会员的dept_id字段和order_item表关联商品的category_id。部门偏好推荐的SQL大概逻辑是查当前用户所在部门的历史订单里买得最多的商品分类然后推荐该分类下当前销量最高或推荐权重最高的若干商品。这个SQL不复杂但非常能体现从数据到业务的思维答辩时老师很容易被打动。3. 前后端实现关键点与实操步骤3.1 后端工程从application.yml到核心接口后端工程拿到手我建议首先看application.yml。这套配置决定了项目能不能在你本地跑起来。核心几项我列一下server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/office_supply?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: 你自己的密码 jackson: date-format: yyyy-MM-dd HH:mm:ss time-zone: GMT8 mybatis-plus: configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl global-config: db-config: logic-delete-field: deleted logic-delete-value: 1 logic-not-delete-value: 0serverTimezoneAsia/Shanghai和characterEncodingutf8这两个参数必须带上。我第一次部署时漏掉了时区配置结果前端页面上显示的时间比实际晚了8小时排查了半天最后发现就是连接串少了时区参数。MySQL 8以上还要求driver-class-name必须写com.mysql.cj.jdbc.Driver写旧的com.mysql.jdbc.Driver会直接启动报错。分层开发的顺序建议是先entity、再mapper、然后service、最后controller。我用了MyBatis-Plus做持久层单表CRUD基本不用手写SQL直接继承BaseMapper就有现成的selectById、insert、updateById。这样做的好处是节省大量重复代码时间但答辩前一定要能说清楚MyBatis-Plus和原生MyBatis的区别以及它帮你省掉了什么。举一个商品分页查询的Controller示例这是前端首页和商品列表页都会调用的接口RestController RequestMapping(/api/product) public class ProductController { Resource private ProductService productService; GetMapping(/page) public Result page(RequestParam(defaultValue 1) int page, RequestParam(defaultValue 12) int size, RequestParam(required false) Integer categoryId, RequestParam(required false) String keyword) { PageProduct dto productService.queryPage(page, size, categoryId, keyword); return Result.success(dto); } }统一返回Result类是前后端联调的关键。我定义所有接口返回{ code: 200, msg: success, data: ... }这种结构前端Axios拦截器统一判断code不等于200就弹出错误提示。这样避免了每个页面各自处理异常代码整洁度提升明显。3.2 用户鉴权与角色控制系统里一定要有管理员接口保护不然商品上下架接口裸奔会显得很不专业。这套系统用的是JWT方案用户登录成功后后端生成一个token字符串前端存在localStorage里每次请求在Header加Authorization: token后端拦截器解析token并判断角色。登录接口的核心逻辑是根据用户名查出用户比对密码BCrypt或MD5查用户角色封装一个LoginVO返回给前端里面包含token和用户基本信息。生成JWT时我用了jwt工具类密钥写在配置里过期时间设为2小时用户操作超时后自动要求重新登录。后端拦截器是重点。我写了一个JwtInterceptor实现HandlerInterceptor接口在preHandle中校验token。同时通过注册配置排除不需要鉴权的路径登录接口、注册接口、商品列表接口可以放行购物车、订单、后台管理接口必须走拦截器。管理员接口再加一层角色校验比如/api/admin/**路径要求角色为管理员不满足直接返回403。前端路由守卫也要做配合。Vue路由配置里meta: { requiresAuth: true, role: admin }来控制页面访问。router.beforeEach里判断用户登录态和角色符合才放行。前后端双重校验才是完整方案只靠前端拦截等于没拦这个点讲出去很加分。3.3 前端工程Vue页面与API封装Vue这套前端我实际是按页面维度拆分的核心页面有Home.vue首页推荐位、ProductList.vue商品列表、ProductDetail.vue商品详情、Cart.vue购物车、OrderList.vue订单列表、AdminProduct.vue后台商品管理、AdminDashboard.vue后台数据面板。Axios封装这块强烈建议你自己动手写一遍再复用。我在api/request.js里创建了一个axios实例设置baseURL为/api然后在请求拦截器里加上token在响应拦截器里统一处理错误码service.interceptors.request.use(config { const token localStorage.getItem(token) if (token) { config.headers.Authorization token } return config }) service.interceptors.response.use( res { if (res.data.code 200) { return res.data.data } ElementMessage.error(res.data.msg) return Promise.reject(new Error(res.data.msg)) }, err { ElementMessage.error(网络异常) return Promise.reject(err) } )封装好request.js之后每个页面的接口调用非常清爽。比如商品详情页只需要export const getProductDetail (id) request.get(/product/detail/ id)页面里onMounted时调用即可。这样统一管理的模式也是公司里协作开发的基本规范写进简历和答辩都有得说。3.4 直售推荐位和购物下单的完整链路下单链路是最值得完整走一遍的功能因为涉及商品、购物车、订单、订单明细、库存五张表的协作。前端购物车结算时点击提交订单携带选中的购物车条目和收货地址调用POST /api/order/create。后端接口逻辑是遍历购物车条目查询商品最新价格和库存校验库存是否充足计算总金额并生成订单主记录状态为待付款然后批量生成订单明细扣减库存清空购物车。整个过程必须使用Transactional否则中间任何一步报错就会出现订单存在但库存没扣、或者购物车已清但订单没生成这类脏数据。事务的坑我之前的的确确踩过。第一次实现时我没有在Service方法上加Transactional测试的时候遇到一次偶发异常结果订单表里多了半条记录明细表只有两件商品却生成了三行数据排查起来非常痛苦。后来养成习惯凡是涉及多表写入的方法方法上必须先加事务注解再进行逻辑编写。推荐位的加载相对简单首页Home.vue在onMounted时调用推荐接口后端根据推荐配置表里的策略分别查出热销、新品、部门偏好的商品列表返回前端。每个推荐位是一个卡片横向滑动区域点击卡片跳转商品详情。这套逻辑是纯后端计算返回数据前端只负责展示维护起来非常省心。4. 常见问题排查与避坑指南4.1 前后端联调的三个经典坑前后端分离项目联调阶段问题集中爆发。我总结项目里最常见的三个问题跨域、路径错误、token丢失。跨域问题表现为浏览器控制台出现CORS policy红字。解决办法在后端加一段WebMvc配置允许前端地址的跨域请求。实际项目中我是这样处理的Configuration public class CorsConfig { Bean public CorsFilter corsFilter() { CorsConfiguration config new CorsConfiguration(); config.addAllowedOrigin(http://localhost:5173); config.addAllowedHeader(*); config.addAllowedMethod(*); config.setAllowCredentials(true); UrlBasedCorsConfigurationSource source new UrlBasedCorsConfigurationSource(); source.registerCorsConfiguration(/**, config); return new CorsFilter(source); } }路径错误通常是前端baseURL与后端RequestMapping前缀不一致。我约定后端统一/api开头前端baseURL设为/api接口方法里只写二级路径能显著减少这类问题。token丢失则要检查前端请求拦截器是否配置正确以及后端拦截器是否把不需要鉴权的路径都排除干净。4.2 下单场景的事务与库存并发前面提到事务这里再补充并发场景。库存扣减如果用先查库存判断足够再update减库存这种三步写法高并发下容易出现超卖。最稳妥的做法是使用MySQL原子更新UPDATE product SET stock stock - #{num} WHERE id #{productId} AND stock #{num}这条SQL影响行数为1说明扣减成功为0说明库存不足。在毕设答辩中被问到如何防止超卖能答出原子更新、行锁、事务回滚这三个层次就已经超出绝大多数学生的水平了。4.3 MySQL配置与数据乱码问题数据乱码基本是字符集问题。建库的SQL要明确指定字符集我实际用的建库语句是CREATE DATABASE office_supply DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;表也建议统一utf8mb4。早期版本MySQL默认字符集可能是latin1Java程序往库里写中文就变成问号。连接串上有characterEncodingutf8数据库和表也是utf8mb4一般就不会再出乱码。另外MySQL 8默认的认证插件是caching_sha2_password如果使用的JDBC驱动版本太老连接时会报Public Key Retrieval is not allowed。解决方法是连接串加allowPublicKeyRetrievaltrue或者升级驱动到8.0以上版本。4.4 环境搭建Java、Maven、Node版本这套系统后端基于SpringBoot 2.x开发JDK要求8以上我用的是JDK 1.8完全兼容。前端Vue如果是2.x配Vue CLINode 14以上即可如果Vue 3配ViteNode最好16以上。以下是常见的环境报错与解决方案做成速查表供参考。问题现象可能原因解决办法Maven依赖下载失败网络原因或镜像源不稳定在settings.xml配置阿里云镜像启动报Invalid bound statementMapper接口与XML未扫描检查MapperScan包路径是否覆盖Node安装后npm run dev报错Node版本过高或过低切换Node LTS版本MySQL连接拒绝服务未启动或密码错误检查MySQL服务与账号权限前端页面接口403未登录或角色不足确认token存在且用户角色正确5. 从源码到毕设/课设的升级建议5.1 怎么把通用源码做出个性化很多人下载源码后改个标题就交差结果老师一问细节就露馅。我建议至少做三处个性化改动第一把所有页面名称、Logo、文案改成你自己设计的项目名比如云采办——企业办公用品直售平台从视觉上先区分第二在数据库初始化脚本里把自己造的一批数据SQL跑一遍并截图作为文档附件第三理解每张表每个字段的含义若被追问至少能回答为什么要设置这个状态字段。代码层面有一个必须改的地方把包名改成你自己的比如com.yourname.office。整个项目搜索替换包名重新编译运行一遍确认换包后依然能跑通所有接口。这不仅是学习过程也是避免一眼抄的重要手段。5.2 三个能让答辩加分的改造方向方向一增加采购审批流。管理员后台可以加一张purchase_apply表员工提交采购申请后需要部门主管审批。订单流程从提交订单到主管审批再到供应商发货多了一个状态节点项目业务深度立刻提升。方向二增加数据可视化。利用后端统计接口输出订单趋势、分类销量排行、用户增长数据前端用ECharts展示成折线图和柱状图。这一项改动不算大但视觉冲击力和答辩表现力很强。方向三增加Excel导入导出。后台商品管理支持Excel批量导入商品订单列表支持导出Excel。用EasyExcel或者POI实现属于企业里非常常见的实际需求讲出来会让人觉得你有工程经验。5.3 答辩陈述的核心思路答辩陈述不建议按页面一个个念功能而是抓住主线讲业务痛点是什么、我设计了什么方案、技术上是如何实现的、遇到什么问题怎么解决的。主线就是直售推荐先说行政采购有中间环节和信息不对称的问题所以设计了供应商直售业务模式然后说员工找品效率低所以设计了基于部门偏好和销量的推荐位最后落到技术上SpringBoot负责接口和业务事务Vue负责交互和状态管理MySQL负责数据的一致性和查询效率。准备几个能主动讲的技术细节比如事务怎么用的、索引怎么建的、JWT怎么设计的、库存防超卖怎么做。老师问到任何一个你都能现场说出思路和代码位置这比背一段项目介绍有用得多。这套项目我断断续续改了很久最深的体会是一个看似普通的商城系统真正把每个细节做好一点都不简单。如果拿到源码我建议你先把数据库跑起来再从前端点一遍功能对着后端日志看每一次请求这个流程走通之后你才真正拥有了这个项目。最后再分享一个小技巧把开发过程中的截图和踩坑记录做成README文档你会发现它能同时帮助你写课程报告、毕设论文和答辩PPT一举三得。