当初在导师的题目清单里看到“基于Spring Boot的宠物咖啡馆平台的设计与实现”时我几乎是瞬间就确定了它。身边养猫养狗的朋友越来越多周末想找个能带着宠物一起喝咖啡的地方并不容易而“宠物咖啡”这个组合切中了这两年很明显的消费趋势。更关键的是一个宠物咖啡馆平台天然覆盖了用户注册登录、信息展示、商品购买、订单流转、座位预约、后台统计这一整个业务闭环几乎把大学里Java后端要学的知识都串起来了。用它做毕业设计既有实际场景又能把一个完整项目做扎实性价比很高。这个平台要做的事情说到底就是两个方向面向顾客提供在线浏览宠物和商品、下单购买、预约座位、查看个人订单的入口面向店家提供宠物信息、商品库存、订单处理、预约管理、会员运营的后台能力。看起来简单真正动手之后才发现从数据库表关系设计、接口命名规范到前端联调、打包部署每一步都有值得记录的细节和坑。这篇文章我就以一个做完整个项目的过来人视角把设计和实现的完整过程摊开聊一遍包括选型的理由、数据库设计的思考、几个核心功能的具体实现方案以及最后验收时容易被问住的问题。想选类似题目的同学可以直接照着这条路线走。1. 项目背景与需求分析1.1 为什么选了“宠物咖啡馆”这个毕设题目先说选题思路。宠物经济这几年的增长非常明显养宠人群在消费决策中越来越愿意为“宠物友好型”场所买单。传统咖啡馆竞争已经很激烈把宠物互动、主题空间融入咖啡馆产品本身就有了差异点和话题性。从软件工程的角度来看这个业务场景非常适合做信息系统它同时具备用户体系、商品交易、资源预约、库存管理和数据统计基本就是把电商和门店预约两种模型合并到了一起正好能展示一个毕业生对业务建模和技术栈的综合运用能力。毕设评审老师其实最关注的就是“你有没有做一个完整的业务闭环”。单纯做一个增删改查管理系统评委很容易问两句就没话聊了。宠物咖啡馆平台的好处在于它天然是一条完整的链路用户注册登录后先浏览宠物和商品把喜欢的咖啡或宠物零食加入购物车下单后走模拟支付再预约一个带着宠物喝咖啡的时段管理员登录后可以管理宠物档案、调整商品库存、处理订单、确认预约。整个流程里用户行为和管理行为互相咬合答辩时把这条链路讲清楚项目的完整度一下就凸显出来了。1.2 用户角色与核心功能盘点这个平台的角色划分很清晰就两类普通用户和管理员。普通用户是咖啡馆的顾客管理员是咖啡馆的店员或店长。需求分析阶段我把功能拆成了前台和后台两块整理成下面这张表功能模块普通用户端管理员后台登录注册支持支持管理员账号宠物浏览查看宠物列表、详情新增、编辑、上架下架、传图商品浏览与购物车按分类浏览、加购物车商品分类、上下架、库存调整订单处理创建订单、我的订单查看全部订单、更新订单状态座位预约选日期时段、提交预约查看预约、确认/取消预约会员与积分查看积分、个人中心调整积分、用户禁用数据统计无仪表盘订单量、营业额、热门商品需求明确了以后功能边界就很清楚。普通用户端主要是浏览、下单、预约和查询管理员端则是维护基础数据和处理交易流程。这里有一个经验不要一开始就把积分商城、优惠券、会员等级这些附加功能堆进来先把主干链路做完再考虑加分项。我身边有同学一上来就设计十几个表最后连核心流程都没跑通这恰恰是选题时容易犯的错。2. 技术选型Spring Boot 为主的理由2.1 为什么用Spring Boot不是Python FastAPI选型阶段我也纠结过要不要用Python的FastAPI毕竟它写接口确实轻快代码量少文档也自动化。但认真评估后我还是回到了Java Spring Boot这条线原因有三层。第一层是工程化效率。Spring Boot把Spring MVC时代的XML配置大量自动化了一个依赖、一份application.yml一个可直接运行的Web服务就有了。加上内嵌Tomcat本地开发不用再单独装和配置服务器这对毕设这种短周期任务非常友好。第二层是生态完整。数据库用MyBatis-Plus缓存用Redis权限用JWT监控用Spring Boot Admin几乎每个环节都有成熟方案不用自己造轮子。第三层是现实收益。国内Java后端岗位的招聘要求里“熟悉Spring Boot”几乎是标配做这样一个项目简历上可以写的东西非常实在面试也能直接拿出来讲。而FastAPI虽然写起来爽但涉及事务管理、权限框架、部署运维时反而要自己拼凑更多方案对展示完整项目能力不如Spring Boot直接。2.2 完整技术栈与版本选择心得我最终确定的技术栈是JDK 8 Spring Boot 2.6.13 MySQL 8.0 MyBatis-Plus 3.5.2 Redis 6 JWT Hutool工具库前端用了Vue3 Element Plus Axios构建工具是Maven。关于Spring Boot版本我得单独提醒一下。网上很多同学纠结是用2.6.x还是3.x。我的实测感受是如果没人硬性要求选2.6.x最稳。Spring Boot 3.0要求JDK 17起步而且很多老依赖从javax命名空间迁到了jakarta网上大量教程还是基于2.x写的你照着做遇到莫名其妙的报错会很崩溃。MyBatis-Plus在2.6.x下用3.5.2完全没问题在3.x下就要升到3.5.3以上。另外Spring Boot 2.3.x的版本稍微老了一点部分依赖在新环境会有兼容性问题2.6.x是2.x时代最成熟的版本之一启动快踩坑记录也最多适合毕设。这里还要提一下IntelliJ IDEA社区版。如果你用的是社区版完全够用只有一个注意点新建项目时不像旗舰版有明显入口但你直接到start.spring.io上选择Dependencies生成zip再导入IDEA就行。记得安装Lombok插件否则entity里的Data注解会直接报编译错误。2.3 后端工程分包与目录规划项目结构我在开工前就规划好了没有用默认的不带分层的包。后端按职责分成这样src/main/java/com/cafe ├── controller # 控制层接收请求参数、调用Service ├── service # 业务层处理具体业务逻辑 │ └── impl # Service接口的实现 ├── mapper # 数据访问层MyBatis-Plus的Mapper ├── entity # 数据库实体 ├── dto # 入参对象接收前端传参 ├── vo # 视图对象返回给前端 ├── config # 配置类WebMvc、跨域、Redis、分页插件 ├── common # 统一返回体、全局异常、常量、自定义异常 └── interceptor # 登录拦截器、管理员权限拦截器这样的分层最大的好处是逻辑清晰。答辩时老师问“一个请求从浏览器到数据库经过哪些层”你能直接答出来Controller接参Service写业务Mapper操作数据每一层各有各的职责。前端单独建一个Vue工程前后端通过JSON交互也算标准的“前后端分离”项目管理端和用户端各一组页面。3. 数据库设计先把表关系想清楚3.1 八张核心表的结构明细我数据库里一共建了8张表用户表、宠物表、商品表、订单表、订单明细表、座位表、预约表、公告表。每张表的设计都考虑过实际业务这里列一下核心字段。用户表id主键、username唯一、passwordBCrypt加密存、nickname、avatar、roleUSER或ADMIN、phone、积分points、创建时间。我一开始纠结要不要单独建会员表最后选择把积分和等级直接放在用户表里因为毕设阶段会员只是加分项拆表会增加开发和维护成本。宠物表id、name、species猫/狗/兔子等、breed品种、age、gender、description、image、status上架或下架。宠物是这个平台的“气氛组”需要支持多字段筛选所以species单独拎出来做字段方便查询。商品表id、name、category咖啡/甜品/宠物零食、pricedecimal(10,2)、stock、image、status、description。价格和库存是交易核心必须用decimal精度float容易出误差。订单表id、order_no唯一订单号、user_id、total_price、status0待支付1已支付2已完成3已取消、create_time。订单号我用“日期随机数”的方式生成避免和别人的并发重复。订单明细表id、order_id、product_id、product_name、price、quantity。明细里冗余存了product_name和price这一点后面专门说。座位表和预约表座位表是id、seat_no、capacity预约表是id、user_id、seat_id、reserve_date、time_slot、status。time_slot用来表示“10:00-12:00”这样的预约时段。公告表id、title、content、create_time用于咖啡馆发布活动公告。3.2 订单快照、库存与会员的冗余取舍订单明细里为什么要冗余存product_name和price因为商品信息是可变的店员今天把“美式咖啡”改名成“冰美式”或者从28块调整到32块如果你在订单明细里只存一个product_id那用户历史订单里显示的商品名和价格都会跟着变这在业务上是错误的。正确的做法是在下单那一刻把商品名称和成交价存进明细表它就是一条不可变的历史快照。这个点不用多高端但体现的是对业务数据的理解答辩时我讲到这里明显感觉评委老师认可。库存管理我没有单独做库存流水表而是只在商品表里维护stock字段。下单时执行条件更新这样可以防止并发超卖UPDATE product SET stock stock - #{quantity} WHERE id #{productId} AND stock #{quantity}这条SQL的意思是只有当当前库存足够时才会真正扣减。如果受影响行数为0说明库存不足就抛业务异常。对毕设项目来说这个方案的简单和有效都够了。3.3 建库初始化与预约冲突的唯一索引建库我用Navicat可视化执行SQL统一用utf8mb4字符集否则宠物简介里一旦存了表情符号就可能乱码。初始化数据我写了一份data.sql插入了美式、拿铁、宠物零食以及几只猫狗的信息和几条座位数据这样系统演示起来不会空空荡荡。要注意的是用Spring Boot自动执行data.sql有时候会很烦每次启动都会重复插数据所以我推荐在MySQL客户端手动执行一次初始化脚本应用启动时只连库不自动执行。预约冲突问题是这个平台的一个核心设计点。预约的本质是“某个座位在某一天某个时段只能被一个人占用”所以我在reservation表上建了唯一索引seat_id, reserve_date, time_slot同时在Service层先做一次查询判断SELECT COUNT(*) FROM reservation WHERE seat_id ? AND reserve_date ? AND time_slot ? AND status IN (0, 1)查询层的作用是返回友好提示“该时段已被预约请更换”唯一索引的作用是兜底防止极端情况下的并发重复插入。这个“双层防重”的思路在答辩时非常加分因为它说明你不是只写了单点查询而是真正考虑了并发一致性。4. 核心功能设计与实现4.1 项目配置与应用启动优化工程建好后第一件事是配置application.yml。这里给出一份我当时用的核心配置server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/cafe?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: 123456 redis: host: localhost port: 6379 servlet: multipart: max-file-size: 10MB max-request-size: 50MB mybatis-plus: configuration: map-underscore-to-camel-case: true log-impl: org.apache.ibatis.logging.stdout.StdOutImpl global-config: db-config: logic-delete-field: deleted logic-delete-value: 1 logic-not-delete-value: 0几个容易被忽略的细节MySQL 8的连接URL里smyserverTimezoneAsia/Shanghai必须配否则启动会直接报时区异常。map-underscore-to-camel-case配置为true之后数据库字段user_name能自动映射到实体的userName属性。全局逻辑删除配置也很重要它让所有删除操作都变成update语句数据不会真正消失。这些配置单看都很小但叠加起来能让开发省大量时间。4.2 用户登录、JWT与权限拦截登录流程是毕设里最基础也最常问的。用户提交用户名密码后Service层先用BCrypt校验密码成功则用JWT生成token把userId、username、role放进token的claims里。前端把token存在本地后续请求在Authorization头里带上。后端通过HandlerInterceptor拦截器解析token解析成功就把用户信息放进ThreadLocal方便在Service里获取当前用户。权限控制我用了两个拦截器。第一个是登录拦截器负责拦截除了登录注册和一些公开浏览接口以外的所有路径第二个是管理员拦截器只拦截路径以/admin开头的接口校验role字段是否为ADMIN。配置类大致是这个结构Configuration public class WebConfig implements WebMvcConfigurer { Override public void addInterceptors(InterceptorRegistry registry) { registry.addInterceptor(loginInterceptor) .addPathPatterns(/**) .excludePathPatterns(/user/login, /user/register, /pet/list, /pet/detail/**, /product/list/**); registry.addInterceptor(adminInterceptor) .addPathPatterns(/admin/**); } }这里我踩过一个很典型的坑拦截器放行路径的写法必须讲究比如我一开始把“/product/list/”误写成“/product/”结果管理员新增商品的接口也被放行了自己测了半天才发现是路径匹配把整个product目录都放开了。这种坑在调试时很难一眼看出来所以建议放行的路径一定要精确到具体资源层次并在写完配置后用不同角色各测一遍。4.3 宠物与商品管理文件上传和动态查询宠物和商品管理本质上就是增删改查加图片上传。宠物列表我用MyBatis-Plus的LambdaQueryWrapper做动态查询按名称模糊搜索、按种类精确筛选再配合分页LambdaQueryWrapperPet wrapper new LambdaQueryWrapper(); wrapper.like(StringUtils.hasText(keyword), Pet::getName, keyword) .eq(StringUtils.hasText(species), Pet::getSpecies, species) .orderByDesc(Pet::getCreateTime); PagePet page petMapper.selectPage(new Page(pageNum, pageSize), wrapper);图片上传的实现我选择了MultipartFile上传到本地磁盘文件名用UUID避免重复再把文件路径存到数据库。上传之后要在浏览器里能正常显示必须在WebMvcConfigurer里配置虚拟路径映射Override public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler(/static/**) .addResourceLocations(file: uploadPath /); }这里有个很实际的经验如果你把上传路径写成绝对路径比如/Users/xxx/upload一旦把项目拷到另一台电脑上验收之前传的图片全部会404。我后来改成在application.yml中写成可配置的相对路径file.upload-path./upload/这样项目目录下会自动生成upload文件夹换电脑也不会出问题。这也是我在实际使用中觉得最实用的小改动之一。4.4 下单、库存扣减与订单状态流转下单是整个系统最核心的业务。我的实现流程是这样的第一步用户从前端购物车提交商品列表第二步Service层重新查一遍商品最新价格这一步很关键因为前端传来的价格不可信第三步生成唯一订单号格式类似202506011530001234第四步循环明细对每个商品执行前面那条条件扣库存SQL第五步全部成功后插入订单表和明细表返回订单号给前端跳转模拟支付页。整个流程必须用一个事务保护起来我加的是Transactional(rollbackFor Exception.class)。注意rollbackFor一定要写因为Spring默认只回滚RuntimeException如果Service里抛的是普通Exception不加rollbackFor就不会回滚。这个坑是很多同学在毕设答辩时被问倒的点。库存扣减的顺序也有讲究我先扣库存再插入订单这样避免了先插入订单后扣库存失败导致产生“幽灵订单”的情况。订单状态的流转我定义了四个值0待支付、1已支付、2已完成、3已取消。待支付订单在下单后如果一直不支付后台可以手动取消或超时未支付自动取消。这个思路虽然简单但符合门店真实运营逻辑。4.5 座位预约与模拟支付预约功能的业务逻辑比下单简单但对时间的处理要细心。前端选好日期、时段、座位后后端插入reservation记录插入前先做查询判断。之前提到的唯一索引和查询判断就在这里起作用。预约状态我用0待确认、1已确认、2已完成、3已取消四个值。管理员在后台看到新预约后点击“确认”用户端就能同步看到预约状态的变化。支付方面我没有对接支付宝或微信而是做了模拟支付用户点击“确认支付”后后端把订单从待支付改成已支付同时给用户增加10个积分。这个设计虽然“假”但把支付回调、订单状态变更、积分发放这三个动作串在了一起。如果你真想体现更多细节可以把模拟支付封装成一个服务接口同时预留将来对接真实支付渠道的扩展点。这样在答辩时就能说清楚我理解了支付流程的核心节点只是基于演示环境做了简化。5. 接口设计与前后端联调5.1 统一返回体与全局异常处理后端接口我统一返回一个Result对象结构是code、msg、data。成功后返回Result.ok(data)失败返回Result.error(msg)。前端在axios里写一个统一的响应拦截器只要code不等于200就弹出错误提示不需要每个页面重复处理错误分支。同时我写了一个全局异常处理器用RestControllerAdvice统一捕获异常把业务异常包装成BizException并返回统一的错误Result。这段设计是整个项目里性价比最高的地方代码量少了接口错误信息也统一了。比如库存不足时Service抛“库存不足”全局处理器自动返回code为500的Result前端弹窗提示逻辑很清晰。5.2 接口路径设计以及开放接口怎么放接口路径我坚持用RESTful风格/pet、/product、/order、/reservation、/user/login等管理端统一加/admin前缀。路径分开的好处是权限拦截器配置起来非常方便前端两个端也容易区分。关于“Spring Boot对外提供的接口给第三方调用应该放在哪里”这个问题我也琢磨过一阵。我的结论是毕设阶段完全不需要拆一个单独的服务出来只需要在对应业务Controller里把面向第三方的接口集中到一个前缀路径下比如/api/open/**再给第三方发一个AppId和密钥接口里做签名校验。如果真到了多团队共用、访问量很大的阶段再考虑拆成独立微服务。能把这个思路讲出来说明你理解了接口开放的基本套路足够应付大部分提问了。5.3 Vue3联调的跨域与传参问题前端用的Vue3 Element Plus前后端分离开发时跨域是个绕不开的问题。我实测下来有两种做法一种是后端配CORS允许前端地址跨域另一种是前端用Vite代理把/api开头的请求转发到localhost:8080。我更推荐前端代理的方式因为后端不需要对非前端来源开放跨域安全边界更清楚。生产部署时用Nginx统一转发这条链路也更顺。传参格式是另一个容易踩坑的地方。普通接口用axios默认的JSON格式后端Controller用RequestBody接收但文件上传接口必须用FormData后端用RequestParam(file)接收MultipartFile。这两者很容易混尤其是下单时如果前端拼错了Content-Type后端永远收到null排查半天都找不到原因。我在axios里写了这样的约定普通请求统一用JSON上传请求单独处理不手动设置Content-Type让浏览器自动生成带boundary的multipart格式。这个细节看起来不起眼但是实际开发中特别实用。6. 监控、部署与验收准备6.1 Spring Boot Admin接入实录毕设如果想在技术深度上增量Spring Boot Admin是性价比很高的选择。它集成起来非常简单并且能在答辩现场直接展示系统运行状态。具体做法是新建一个Spring Boot工程作为admin-server引入依赖并在启动类加EnableAdminServer运行起来后就是一个监控台。被监控的业务端引入spring-boot-admin-starter-client在application.yml里配置admin server地址同时开放Actuator端点spring: boot: admin: client: url: http://localhost:8081 management: endpoints: web: exposure: include: *启动之后我可以打开admin-server页面看到业务应用实例的在线状态、JVM内存曲线、线程数量、HTTP请求映射甚至能在线修改日志级别。答辩时现场打开这个页面给老师看一眼内存占用和请求映射表比说一堆性能优化理论更有说服力。6.2 打包与换环境运行毕设验收经常需要在教室电脑或借来的笔记本上现场演示打包策略特别重要。我的方案是前端npm run build生成dist目录把它复制到后端项目的src/main/resources/static目录下Spring Boot会直接把前端页面也托管起来最终一个jar包搞定所有内容。这样部署时不需要单独装Nginx也不存在跨域问题对演示环境非常友好。后端打包用mvn clean package -DskipTests得到target目录下的jar包运行命令是java -jar cafe-platform-0.0.1-SNAPSHOT.jar需要注意演示电脑需要装JDK8和MySQL。如果没装Redis可以把缓存逻辑临时降级成本地Map但我建议还是保留Redis毕竟它是技术栈里的加分项。数据库连接账号密码要和application.yml保持一致最好在打包前新建一个prod配置通过-Dspring.profiles.activeprod切换这样不至于打包后还得改代码。6.3 常见问题速查表整理一下我实际踩过、以及帮同学排查过的常见问题做成速查表现象原因解决办法启动报Access denied for user数据库账号密码错误或权限不足检查application.yml和MySQL用户授权8080端口被占用其他进程占用用netstat -ano查端口换端口或结束进程中文乱码数据库连接没指定utf8连接URL加characterEncodingutf8图片上传后访问404没有配置资源映射在WebMvcConfigurer里addResourceHandlerstoken失效后接口报错拦截器没写友好返回在拦截器里直接写JSON响应查询返回null但数据库有值实体字段没映射上检查map-underscore-to-camel-case或加TableFieldMyBatis-Plus分页失效缺少分页插件配置PaginationInterceptor事务不生效没加rollbackFor或方法内部调用加rollbackForException.class避免同类内部调用最隐蔽的就是事务不生效那个。如果你在Service里A方法调用同一个类里的B方法B上的Transactional是不生效的因为Spring事务是通过代理实现的同类内部调用绕过了代理。解决方法是把B方法拆到另一个Service类里或者自己注入自己再调用。这个点能想明白说明你对Spring的原理不是只会背代码。另外前后端联调时如果接口报404检查一下路径有没有拼错报500看控制台日志有没有SQL异常报跨域先确认前端代理有没有生效。这些基础排查思路掌握了现场调试基本不会慌。回头看这个基于Spring Boot的宠物咖啡馆平台技术难度不算特别高但胜在业务完整、技术栈主流。我个人最大的体会是选题阶段把“业务闭环”放在第一位比追求花哨的框架更重要。一个贴近日常生活的场景通过自己亲手写的代码完整跑通这种成就感是刷几十道面试题都比不上的。最后分享一个答辩技巧评委老师特别喜欢问“为什么”做PPT时把“为什么选择Spring Boot”“为什么订单明细要冗余商品快照”“为什么预约要做双层防重”这些问题提前想明白答辩时就能对答如流。如果后续还想继续扩展这个项目可以往微信小程序端、真实在线支付、宠物领养模块、订单消息通知这些方向走每一步都是新收获。