每年到这个时间点后台就会涌进来一大波“基于Spring Boot的XXX系统”的毕业设计求助流浪动物领养系统算是其中很有代表性的一类。这个选题有意思的地方在于它不像电商系统那么烂大街又比图书管理这种纯CRUD多了一层业务逻辑关键在于“领养申请审核”这个流程能让答辩老师有东西可问学生也有东西可讲。标题里提到了“选题开题任务书中期报告程序设计LW答辩ppt全流程”其实这正是一个完整的毕设项目从立项到交付的全生命周期。这篇文章我就以我实际带过多个这类项目的经验把“基于SpringBoot的流浪动物领养系统”从需求拆解、技术选型、数据库设计、核心功能实现到答辩准备从头到尾捋一遍给正在做类似题目的朋友一份可以直接参考的实操笔记。1. 需求拆解与整体设计思路1.1 这个系统到底在解决什么问题流浪动物领养系统本质上是一个信息撮合平台一端是拥有或发现流浪动物的送养人他们需要把动物信息发布出来另一端是想领养动物的爱心人士他们需要浏览、筛选、然后提交领养申请。中间还必须有管理员做内容把关避免虚假信息、恶意发布并且对领养过程进行一定程度的管理。这个定位很重要因为它直接决定了角色的划分送养人发布宠物信息、下架宠物、查看收到的领养申请、审核领养人资质、确认送养。领养人浏览宠物信息、收藏心仪的宠物、提交领养申请、填写领养问卷、查看申请状态。管理员用户管理禁用/启用、宠物信息审核、公告发布、数据统计。很多人一开始会把权限做得很复杂比如送养人和领养人完全分开注册。实际做下来一个用户完全可以既是送养人又是领养人。所以我一般建议采用“用户 角色”的简单模型系统给用户分配一个基础角色普通用户另外设一个管理员账号普通用户拥有送养和领养的全部功能通过功能层面的引导来区分使用场景。这样既简化了设计又不会牺牲功能完整性。1.2 技术栈选型的几条基本原则这个项目用Spring Boot为主体框架前端搭配Vue或者Thymeleaf都是主流。我个人的建议是如果你的前端功底还不错选前后端分离的Vue Spring Boot组合答辩是加分项如果时间紧、只想稳住功能用Thymeleaf模板引擎做服务端渲染也不丢人毕竟它部署简单少了一堆跨域、打包的麻烦。后端核心依赖一般就这些Spring Boot 2.7.x JDK 8/11不用追求最新版稳定才是毕设的第一诉求MyBatis-Plus单表CRUD几乎不用写SQL分页、条件查询都有现成的Spring Security JWT或者干脆用拦截器 Redis管理Session/TokenMySQL 5.7/8.0文件存储本地磁盘目录存储 数据库存路径或者用MinIO做对象存储这里要特别说一句如果你看到有些教程推荐Spring Boot 3.x请务必注意JDK的版本要求。Spring Boot 3要求JDK 17以上而且很多坑都出在 javax 到 jakarta 的包名迁移上。对于毕设这种目的稳定跑通、答辩流畅比追求新技术版本重要得多。1.3 功能模块如何划分才清晰按我常用的划分方式功能模块可以拆成六大块用户认证模块注册、登录、退出、密码加密存储、JWT令牌签发与校验。宠物信息管理发布宠物、编辑宠物资料、上下架、上传多张宠物图片、管理员审核。领养申请模块用户提交领养申请、填写动物喂养经验、家庭环境、领养承诺等信息送养人查看申请并审核。审核与状态流转宠物信息状态机设计待审核、审核通过、已领养、已下架、领养申请状态机待审核、已通过、已拒绝。平台管理后台管理员登录后台用户管理、宠物审核、公告发布、基础数据统计。辅助功能公告栏、宠物收藏、搜索与分类筛选。把这些梳理成一张表来看每个模块的关键交互对象和核心操作会非常直观模块操作角色核心功能关键状态用户认证所有用户注册登录、令牌刷新登录态过期/有效宠物信息管理送养人、管理员发布、编辑、上下架、审核待审核/已通过/已拒绝领养申请领养人、送养人提交申请、审核、确认送养待审核/已通过/已拒绝/已完成管理后台管理员用户封禁、宠物管理、公告、统计无辅助功能所有用户收藏、搜索、公告查看无2. 数据库设计与状态流转细节2.1 核心表结构与关键字段设计数据库设计是整个系统的地基地里没埋好雷后续写代码就是一路踩坑。我根据经验整理了一份最小可用的表清单用户表user字段包括id、username、passwordBCrypt加密后存储、phone、email、avatar、role0普通用户1管理员、status0正常1禁用、create_time。密码加密这一点必须用BCrypt不能明文存答辩的时候老师很容易问到这个问题。宠物信息表pet字段包括id、pet_name、category猫/狗/其他、breed、age_months、gender、vaccinated是否已免疫、neutered是否已绝育、health_desc健康状况描述、images图片路径多个用逗号分隔、status、publisher_id、publish_time。这里有个容易踩的坑宠物图片不要只存一个字段因为一只动物往往有多张照片。用逗号分隔存储是简单做法但如果你前端展示的时候需要提取首图做列表封面SQL里直接用函数处理会有兼容性问题更稳妥的方案是再单独建一张宠物图片表。领养申请表adoption_apply字段包括id、pet_id、applicant_id、message申请留言、has_experience是否有养宠经验、home_environment居住环境描述、status、create_time、review_comment。收藏表favorite用户收藏宠物用唯一约束可以设为user_id, pet_id防止重复收藏。公告表notice管理员发布平台公告普通用户在前端首页可见。管理操作日志表可选记录管理员的关键操作如审核通过、用户封禁等。这个表做出来很加好感答辩时说“我们做了审计日志”会显得你有工程意识。2.2 宠物状态机的合理设计状态机是这类系统最值得讲给评委听的设计重点。宠物信息从发布到最终被领养至少应该有以下几个状态0 待审核用户发布后需要管理员审核未审核的宠物对他人不可见。1 已上架审核通过前台可浏览、可申请领养。2 已领养某个领养申请被确认宠物不能再被申请。3 已下架送养人主动下架或者管理员违规下架。为什么要设计“待审核”状态很多同学图省事发布即展示。但这个系统的现实场景是“动物信息虚假”和“恶意发布”是平台最大的风险一个看起来正规的系统必须要有信息把关的环节。从答辩角度讲这也是你区别于“纯CRUD演示”的重要亮点。领养申请的状态设计0 待审核送养人尚未处理。1 已通过送养人同意此申请宠物状态同步改为“已领养”。2 已拒绝送养人不同意可填写拒绝原因。这里有一个细节要特别注意同一只宠物当一个申请通过并完成领养后其他所有待审核的申请都应自动标记为“已拒绝”避免出现状态不一致的脏数据。这个逻辑可以用一个事务方法来实现也是问答里的好素材。3. 后端核心模块与代码实现3.1 项目结构与统一返回体设计后端项目我习惯按“controller/service/mapper/entity/common/config”包结构组织。common包下放统一返回体Result、全局异常处理器、JWT工具类等保证业务代码干净。统一返回体一般设计成这样前端解码非常方便Data public class ResultT { private Integer code; // 200表示成功其他表示失败 private String message; private T data; public static T ResultT success(T data) { ResultT result new Result(); result.code 200; result.message success; result.data data; return result; } public static T ResultT error(String message) { ResultT result new Result(); result.code 500; result.message message; return result; } }全局异常处理用Spring Boot的RestControllerAdvice加上ExceptionHandler处理业务异常、参数校验异常和兜底异常。这里的价值在于任何异常都能给前端返回符合统一结构的JSON而不是一坨让人摸不着头脑的默认错误页。这也是可以从项目初期就养成的好习惯。3.2 认证授权与拦截器采用JWT做无状态认证是这类系统的主流方案。用户登录成功后后端生成一个包含用户ID和角色的JWT令牌返回给前端前端在之后的请求中在请求头里带上这个令牌后端通过拦截器解析令牌识别用户身份。Component public class JwtInterceptor implements HandlerInterceptor { Autowired private StringRedisTemplate redisTemplate; Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { // 放行预检请求 if (OPTIONS.equalsIgnoreCase(request.getMethod())) { return true; } String token request.getHeader(Authorization); if (token ! null token.startsWith(Bearer )) { token token.substring(7); // 校验token有效性 Claims claims JwtUtil.parseToke(token); if (claims ! null) { request.setAttribute(userId, claims.get(userId)); return true; } } response.setStatus(401); response.setContentType(application/json;charsetUTF-8); response.getWriter().write({\code\:401,\message\:\未登录或登录已过期\}); return false; } }更完善的做法是把token存一份到Redis设置过期时间用户退出时主动删除实现真正可控的登录失效。我以前带人做这个项目时试过纯JWT不靠服务端保存后来发现一个很尴尬的问题你没法封禁某个已经登录的用户。加了Redis后这个问题就解决了管理员禁用用户后只要服务端逻辑里加一层用户状态检查就能立刻生效。身份识别用户后在需要管理员权限的接口上做角色校验可以用简单的注解加拦截器实现也可以引入Spring Security的注解。自定义注解看起来更“极客”也更容易讲清楚原理。3.3 宠物发布与图片上传功能实现图片上传是一个高频功能也是出问题最多的地方。Spring Boot默认的上传文件大小只有1MB一次性上传多张宠物图片必须手动调大配置spring: servlet: multipart: max-file-size: 5MB max-request-size: 20MB当时我在做图片上传时为了让生成的图片路径尽量唯一用了“日期目录 UUID 原文件名后缀”的方式。比如2025/06/01/xxxxxx.jpg这样上传的图片在服务器上不会重名也好管理。但这里有个大坑上传后图片存到了本地磁盘但是浏览器访问不了因为Spring Boot默认不会把磁盘上的图片目录暴露成静态资源。需要自己写配置映射Configuration public class WebConfig implements WebMvcConfigurer { Value(${file.upload-dir}) private String uploadDir; Override public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler(/uploads/**) .addResourceHandler(file: uploadDir); } }这样前端就能直接访问http://localhost:8080/uploads/xxx.jpg了。这里演示的是本地存储方案如果做得更贴近企业级的做法会用MinIO或者阿里云OSS代替本地磁盘但核心思路是相通的数据库里保存的是相对路径而不是完整的URL地址避免迁移服务器后数据全部失效。MinIO加入到SpringBoot项目中也是这两年搜热词里常出现的方向如果你想让项目有亮点可以考虑把图片存储换成MinIO然后写一个FileStorageService接口本地存储一个实现、MinIO一个实现通过配置文件切换。这种对扩展开放的设计在答辩时非常有说服力。3.4 领养申请流程的完整闭环申请领养的流程值得仔细设计它是这个系统的业务核心也最容易把你的项目和其他人的“CRUD项目”拉开差距。我设计的流程如下领养人在宠物详情页点击“申请领养”填写申请表单。表单数据提交后创建一条adoption_apply记录状态为待审核。送养人在“我发布的宠物 - 领养申请”列表里看到申请记录。送养人点击“通过”系统事务性地处理三个操作更新申请状态为已通过更新宠物状态为已领养把该宠物其他待审核申请批量置为已拒绝送养人点击“拒绝”填写原因仅更新申请状态为拒绝。这段事务代码是项目里最值得展示的部分Transactional(rollbackFor Exception.class) public boolean approveApply(Integer applyId) { AdoptionApply apply applyMapper.selectById(applyId); if (apply null || apply.getStatus() ! 0) { throw new BusinessException(申请不存在或已处理); } // 1. 通过当前申请 apply.setStatus(1); applyMapper.updateById(apply); // 2. 宠物标记为已领养 Pet pet new Pet(); pet.setId(apply.getPetId()); pet.setStatus(2); petMapper.updateById(pet); // 3. 该宠物其他待审核申请自动拒绝 LambdaUpdateWrapperAdoptionApply updateWrapper new LambdaUpdateWrapper(); updateWrapper.eq(AdoptionApply::getPetId, apply.getPetId()) .eq(AdoptionApply::getStatus, 0) .ne(AdoptionApply::getId, applyId) .set(AdoptionApply::getStatus, 2); applyMapper.update(null, updateWrapper); return true; }这段代码量不大但信息密度很高。事务保证了“申请通过、宠物状态变更、其他申请拒绝”这三件事要么全部成功要么全部失败MyBatis-Plus的LambdaQueryWrapper也展示了条件构造器的用法。就这一段已经能撑起答辩时5分钟的深度提问了。3.5 检索、筛选与收藏功能的细节处理首页的宠物列表一般需要一个搜索区域支持按关键词名称/品种、按动物类别、按是否免疫/绝育进行筛选。这里可以用MyBatis-Plus的LambdaQueryWrapper或者直接用Page的分页查询。关键点在“列表数据不要直接返回宠物表全字段”尤其是health_desc这种长文本放在列表接口里纯粹是浪费带宽。建议在实体上使用TableField或自定义VO列表接口只返回id、名称、类别、主图、年龄、是否免疫等核心展示字段详情接口再返回完整信息。收藏功能关注一个细节用户点收藏前要先查询该用户是否已收藏过这只宠物。利用数据库唯一约束兜底插入时捕获DuplicateKeyException这样即使前端连续点了两次也不会产生脏数据。前端拿到返回结果后可以及时切换收藏图标的选中状态交互体验就好了不少。4. 前端核心页面设计要点4.1 前台用户端页面与交互如果采用前后端分离方案前端推荐Vue 2/3 Element UI/Element Plus。首页建议包含几个区域导航栏、顶部轮播图或公告栏、宠物卡片列表带封面图、名称、类别标签、搜索筛选栏。宠物卡片点击进入详情页详情页展示多张图片、基础信息、健康状况描述和“申请领养”按钮。这里有一个很实际的前端问题图片加载失败怎么办。后端返回的图片路径中可能因为服务器迁移、文件被删等原因已经失效。Vue里用error事件统一替换成一张默认占位图是很实用的小技巧。申请领养的表单不要做得过于复杂最好是姓名、电话自动带出然后加手机号、微信号、居住情况、养宠经验、领养理由这几个字段就够了。太多字段会让用户失去耐心太少字段送养人又没法判断这本身就是一个产品设计的权衡。4.2 后台管理页面的布局管理员后台用单独的登录入口页面偏简约即可。侧边栏放用户管理、宠物审核、公告管理、数据统计几个菜单。宠物审核页是最能体现业务功能的页面管理员看到的是“待审核宠物列表”每条数据有“查看详情”“通过”“驳回”三个操作。驳回时必须填原因驳回后该宠物信息被标记为审核失败用户端可见并且在用户“我的发布”里能显示审核失败原因。数据统计页可以放四个大数字卡片用户总数、宠物总数、今日新增申请、领养成功数再放一张按月份统计的柱状图可以用ECharts。这部分代码量不大但页面一出来整个系统马上就显得立体了。5. 常见问题与排查技巧实录每次带项目的时候遇到的问题翻来覆去就那几类这里我整理一个排查表方便你有据可查现象可能原因解法Spring Boot项目启动报Failed to configure a DataSource未配置数据源或MyBatis扫描不到确认application.yml中数据库地址、账号密码主类上注意MapperScan上传图片提示FileSizeLimitExceededException上传文件大小超过Spring默认1MB修改multipart配置调大max-file-size前端图片全部加载失败资源映射未配置实现WebMvcConfigurer中的addResourceHandlers映射磁盘图片目录登录后请求接口一直401请求头没带Authorization或JWT校验失败前端拦截器统一添加请求头后端打印日志检查token解析结果表字段带下划线查询结果却是nullMyBatis-Plus未开启驼峰映射开启map-underscore-to-camel-case或使用TableField映射跨域请求CORS报错前后端分离但未配置跨域在Spring Boot中配置CorsFilter或实现WebMvcConfigurer添加跨域映射Invalid bound statement (not found)Mapper接口的xml路径没对检查resources目录下xml的namespace是否正确mapper-locations是否配置时间字段差8小时数据库连接未指定时区URL上加serverTimezoneAsia/Shanghai5.1 Spring Boot版本与依赖兼容性这是重灾区。我看到太多人因为跟着某个新教程用了Spring Boot 3.x结果发现数据库驱动、MyBatis-Plus、Spring Security等一堆依赖全部需要升级适配卡了好几天。如果你是第一次做完整的Spring Boot项目直接选2.7.x。MyBatis-Plus的版本建议不要用太老的3.4.x有条件用3.5.3以上的它对Spring Boot 2.7的适配比较成熟。如果用了Spring Boot 3请换到MyBatis-Plus 3.5.5以上版本并且记得是mybatis-plus-spring-boot3-starter这个包名。5.2 部署与演示阶段的注意事项毕设答辩那天现场翻车的情况我也见过不少有几个细节值得提前演练提前确认数据库服务已启动账号密码配置正确。每年都有现场数据库连不上的事故。图片上传目录权限问题在Linux服务器上很常见本地Windows没这事但如果用了云服务器部署目录的写权限需要提前检查。演示时一定要把宠物模块、申请流程、管理员审核这几个核心环节的演示顺序理好不要等答辩老师问“你这个领养流程能走通吗”你才现场现点。视频备份的图片和数据库文件拷一份到电脑/网盘不然万一本地环境炸了一切从头开始。6. 论文写作与答辩准备的几条实战经验6.1 论文结构怎么搭不空洞很多人的论文写出来被老师批“像说明书”核心问题在于只写了“功能是什么”没有写“为什么要这样做、怎么实现的、遇到什么问题”。我建议提纲这么排第一章 绪论项目背景。重点写流浪动物问题的社会现状、线下领养的信息不对称痛点最后引出系统的研究意义。第二章 相关技术介绍写Spring Boot的核心机制自动装配原理是很值得展开的点、MyBatis-Plus、Vue、JWT等不要粘贴大段命令要讲清楚你用到的技术分别在项目里承担什么角色。第三章 系统需求分析画用例图、功能模块图、非功能需求安全性、性能、可维护性。第四章 系统设计架构设计、技术架构图、数据库详细设计每个表都要配字段说明表状态流程设计。第五章 系统实现按“功能模块关键代码界面截图功能描述”四件套来组织每个模块至少写2-3页。第六章 系统测试功能测试用例表、测试结果、代表性页面截图。测试部分很多人凑字数其实可以用测试用例表把每个模块的测试步骤、预期结果、实际结果列出来很充实。6.2 答辩现场老师常问的几个问题我总结下来这类题目的答辩问题基本逃不出这几个方向“Spring Boot自动装配是怎么实现的和传统Spring有什么区别”这时候你把SpringBootApplication里的三大注解拆开讲说到EnableAutoConfiguration通过spring.factories加载配置类就能拿个不错的分数。“为什么不直接用传统三层架构里的service里new对象而要用依赖注入”这题是考察IoC的理解用代码举例说明解耦的好处。“你这个图片上传存到了哪里如果服务器重启/换服务器会不会出问题”这题直接答到本地磁盘存储的局限再接一句“我在设计时预留了对象存储的扩展接口”妥妥体现工程视野。“同一只宠物多个领养申请你如何保证不会重复领养”把前面的事务代码搬出来讲一遍即可。“JWT和Session有什么区别为什么选择JWT”从无状态、分布式友好、前后端分离适配等角度答。写在最后以上这些基本就是我带这个题目从0到1完整走一遍的全过程。说实在的这个项目不管你是不是冲着“毕设”来做的它的业务模型都挺能训练人的有认证授权、有状态流转、有事务控制、有文件上传、有权限区分几乎把Spring Boot在实际项目中的主力玩法都过了一遍。要说一个最值得多花时间的点我个人的体会是这个项目最提分的不是代码多花哨而是逻辑闭环。发布-审核-申请-审核确认-状态互斥这条链走通走顺图和代码一起展示现场绝对能聊起来。别把时间全耗在页面样式上把状态机和事务处理透后面论文和答辩都会顺很多。如果你正在做这个题目希望这份笔记能让你省下几天试错时间。代码不是最难的最难的是能自己讲清楚每一处设计背后的原因。从需求开始一砖一瓦把系统搭起来这个过程完成了论文和答辩都只是顺水推舟的事情。 基于SpringBoot的流浪动物领养系统设计全流程实战
每年到这个时间点后台就会涌进来一大波“基于Spring Boot的XXX系统”的毕业设计求助流浪动物领养系统算是其中很有代表性的一类。这个选题有意思的地方在于它不像电商系统那么烂大街又比图书管理这种纯CRUD多了一层业务逻辑关键在于“领养申请审核”这个流程能让答辩老师有东西可问学生也有东西可讲。标题里提到了“选题开题任务书中期报告程序设计LW答辩ppt全流程”其实这正是一个完整的毕设项目从立项到交付的全生命周期。这篇文章我就以我实际带过多个这类项目的经验把“基于SpringBoot的流浪动物领养系统”从需求拆解、技术选型、数据库设计、核心功能实现到答辩准备从头到尾捋一遍给正在做类似题目的朋友一份可以直接参考的实操笔记。1. 需求拆解与整体设计思路1.1 这个系统到底在解决什么问题流浪动物领养系统本质上是一个信息撮合平台一端是拥有或发现流浪动物的送养人他们需要把动物信息发布出来另一端是想领养动物的爱心人士他们需要浏览、筛选、然后提交领养申请。中间还必须有管理员做内容把关避免虚假信息、恶意发布并且对领养过程进行一定程度的管理。这个定位很重要因为它直接决定了角色的划分送养人发布宠物信息、下架宠物、查看收到的领养申请、审核领养人资质、确认送养。领养人浏览宠物信息、收藏心仪的宠物、提交领养申请、填写领养问卷、查看申请状态。管理员用户管理禁用/启用、宠物信息审核、公告发布、数据统计。很多人一开始会把权限做得很复杂比如送养人和领养人完全分开注册。实际做下来一个用户完全可以既是送养人又是领养人。所以我一般建议采用“用户 角色”的简单模型系统给用户分配一个基础角色普通用户另外设一个管理员账号普通用户拥有送养和领养的全部功能通过功能层面的引导来区分使用场景。这样既简化了设计又不会牺牲功能完整性。1.2 技术栈选型的几条基本原则这个项目用Spring Boot为主体框架前端搭配Vue或者Thymeleaf都是主流。我个人的建议是如果你的前端功底还不错选前后端分离的Vue Spring Boot组合答辩是加分项如果时间紧、只想稳住功能用Thymeleaf模板引擎做服务端渲染也不丢人毕竟它部署简单少了一堆跨域、打包的麻烦。后端核心依赖一般就这些Spring Boot 2.7.x JDK 8/11不用追求最新版稳定才是毕设的第一诉求MyBatis-Plus单表CRUD几乎不用写SQL分页、条件查询都有现成的Spring Security JWT或者干脆用拦截器 Redis管理Session/TokenMySQL 5.7/8.0文件存储本地磁盘目录存储 数据库存路径或者用MinIO做对象存储这里要特别说一句如果你看到有些教程推荐Spring Boot 3.x请务必注意JDK的版本要求。Spring Boot 3要求JDK 17以上而且很多坑都出在 javax 到 jakarta 的包名迁移上。对于毕设这种目的稳定跑通、答辩流畅比追求新技术版本重要得多。1.3 功能模块如何划分才清晰按我常用的划分方式功能模块可以拆成六大块用户认证模块注册、登录、退出、密码加密存储、JWT令牌签发与校验。宠物信息管理发布宠物、编辑宠物资料、上下架、上传多张宠物图片、管理员审核。领养申请模块用户提交领养申请、填写动物喂养经验、家庭环境、领养承诺等信息送养人查看申请并审核。审核与状态流转宠物信息状态机设计待审核、审核通过、已领养、已下架、领养申请状态机待审核、已通过、已拒绝。平台管理后台管理员登录后台用户管理、宠物审核、公告发布、基础数据统计。辅助功能公告栏、宠物收藏、搜索与分类筛选。把这些梳理成一张表来看每个模块的关键交互对象和核心操作会非常直观模块操作角色核心功能关键状态用户认证所有用户注册登录、令牌刷新登录态过期/有效宠物信息管理送养人、管理员发布、编辑、上下架、审核待审核/已通过/已拒绝领养申请领养人、送养人提交申请、审核、确认送养待审核/已通过/已拒绝/已完成管理后台管理员用户封禁、宠物管理、公告、统计无辅助功能所有用户收藏、搜索、公告查看无2. 数据库设计与状态流转细节2.1 核心表结构与关键字段设计数据库设计是整个系统的地基地里没埋好雷后续写代码就是一路踩坑。我根据经验整理了一份最小可用的表清单用户表user字段包括id、username、passwordBCrypt加密后存储、phone、email、avatar、role0普通用户1管理员、status0正常1禁用、create_time。密码加密这一点必须用BCrypt不能明文存答辩的时候老师很容易问到这个问题。宠物信息表pet字段包括id、pet_name、category猫/狗/其他、breed、age_months、gender、vaccinated是否已免疫、neutered是否已绝育、health_desc健康状况描述、images图片路径多个用逗号分隔、status、publisher_id、publish_time。这里有个容易踩的坑宠物图片不要只存一个字段因为一只动物往往有多张照片。用逗号分隔存储是简单做法但如果你前端展示的时候需要提取首图做列表封面SQL里直接用函数处理会有兼容性问题更稳妥的方案是再单独建一张宠物图片表。领养申请表adoption_apply字段包括id、pet_id、applicant_id、message申请留言、has_experience是否有养宠经验、home_environment居住环境描述、status、create_time、review_comment。收藏表favorite用户收藏宠物用唯一约束可以设为user_id, pet_id防止重复收藏。公告表notice管理员发布平台公告普通用户在前端首页可见。管理操作日志表可选记录管理员的关键操作如审核通过、用户封禁等。这个表做出来很加好感答辩时说“我们做了审计日志”会显得你有工程意识。2.2 宠物状态机的合理设计状态机是这类系统最值得讲给评委听的设计重点。宠物信息从发布到最终被领养至少应该有以下几个状态0 待审核用户发布后需要管理员审核未审核的宠物对他人不可见。1 已上架审核通过前台可浏览、可申请领养。2 已领养某个领养申请被确认宠物不能再被申请。3 已下架送养人主动下架或者管理员违规下架。为什么要设计“待审核”状态很多同学图省事发布即展示。但这个系统的现实场景是“动物信息虚假”和“恶意发布”是平台最大的风险一个看起来正规的系统必须要有信息把关的环节。从答辩角度讲这也是你区别于“纯CRUD演示”的重要亮点。领养申请的状态设计0 待审核送养人尚未处理。1 已通过送养人同意此申请宠物状态同步改为“已领养”。2 已拒绝送养人不同意可填写拒绝原因。这里有一个细节要特别注意同一只宠物当一个申请通过并完成领养后其他所有待审核的申请都应自动标记为“已拒绝”避免出现状态不一致的脏数据。这个逻辑可以用一个事务方法来实现也是问答里的好素材。3. 后端核心模块与代码实现3.1 项目结构与统一返回体设计后端项目我习惯按“controller/service/mapper/entity/common/config”包结构组织。common包下放统一返回体Result、全局异常处理器、JWT工具类等保证业务代码干净。统一返回体一般设计成这样前端解码非常方便Data public class ResultT { private Integer code; // 200表示成功其他表示失败 private String message; private T data; public static T ResultT success(T data) { ResultT result new Result(); result.code 200; result.message success; result.data data; return result; } public static T ResultT error(String message) { ResultT result new Result(); result.code 500; result.message message; return result; } }全局异常处理用Spring Boot的RestControllerAdvice加上ExceptionHandler处理业务异常、参数校验异常和兜底异常。这里的价值在于任何异常都能给前端返回符合统一结构的JSON而不是一坨让人摸不着头脑的默认错误页。这也是可以从项目初期就养成的好习惯。3.2 认证授权与拦截器采用JWT做无状态认证是这类系统的主流方案。用户登录成功后后端生成一个包含用户ID和角色的JWT令牌返回给前端前端在之后的请求中在请求头里带上这个令牌后端通过拦截器解析令牌识别用户身份。Component public class JwtInterceptor implements HandlerInterceptor { Autowired private StringRedisTemplate redisTemplate; Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { // 放行预检请求 if (OPTIONS.equalsIgnoreCase(request.getMethod())) { return true; } String token request.getHeader(Authorization); if (token ! null token.startsWith(Bearer )) { token token.substring(7); // 校验token有效性 Claims claims JwtUtil.parseToke(token); if (claims ! null) { request.setAttribute(userId, claims.get(userId)); return true; } } response.setStatus(401); response.setContentType(application/json;charsetUTF-8); response.getWriter().write({\code\:401,\message\:\未登录或登录已过期\}); return false; } }更完善的做法是把token存一份到Redis设置过期时间用户退出时主动删除实现真正可控的登录失效。我以前带人做这个项目时试过纯JWT不靠服务端保存后来发现一个很尴尬的问题你没法封禁某个已经登录的用户。加了Redis后这个问题就解决了管理员禁用用户后只要服务端逻辑里加一层用户状态检查就能立刻生效。身份识别用户后在需要管理员权限的接口上做角色校验可以用简单的注解加拦截器实现也可以引入Spring Security的注解。自定义注解看起来更“极客”也更容易讲清楚原理。3.3 宠物发布与图片上传功能实现图片上传是一个高频功能也是出问题最多的地方。Spring Boot默认的上传文件大小只有1MB一次性上传多张宠物图片必须手动调大配置spring: servlet: multipart: max-file-size: 5MB max-request-size: 20MB当时我在做图片上传时为了让生成的图片路径尽量唯一用了“日期目录 UUID 原文件名后缀”的方式。比如2025/06/01/xxxxxx.jpg这样上传的图片在服务器上不会重名也好管理。但这里有个大坑上传后图片存到了本地磁盘但是浏览器访问不了因为Spring Boot默认不会把磁盘上的图片目录暴露成静态资源。需要自己写配置映射Configuration public class WebConfig implements WebMvcConfigurer { Value(${file.upload-dir}) private String uploadDir; Override public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler(/uploads/**) .addResourceHandler(file: uploadDir); } }这样前端就能直接访问http://localhost:8080/uploads/xxx.jpg了。这里演示的是本地存储方案如果做得更贴近企业级的做法会用MinIO或者阿里云OSS代替本地磁盘但核心思路是相通的数据库里保存的是相对路径而不是完整的URL地址避免迁移服务器后数据全部失效。MinIO加入到SpringBoot项目中也是这两年搜热词里常出现的方向如果你想让项目有亮点可以考虑把图片存储换成MinIO然后写一个FileStorageService接口本地存储一个实现、MinIO一个实现通过配置文件切换。这种对扩展开放的设计在答辩时非常有说服力。3.4 领养申请流程的完整闭环申请领养的流程值得仔细设计它是这个系统的业务核心也最容易把你的项目和其他人的“CRUD项目”拉开差距。我设计的流程如下领养人在宠物详情页点击“申请领养”填写申请表单。表单数据提交后创建一条adoption_apply记录状态为待审核。送养人在“我发布的宠物 - 领养申请”列表里看到申请记录。送养人点击“通过”系统事务性地处理三个操作更新申请状态为已通过更新宠物状态为已领养把该宠物其他待审核申请批量置为已拒绝送养人点击“拒绝”填写原因仅更新申请状态为拒绝。这段事务代码是项目里最值得展示的部分Transactional(rollbackFor Exception.class) public boolean approveApply(Integer applyId) { AdoptionApply apply applyMapper.selectById(applyId); if (apply null || apply.getStatus() ! 0) { throw new BusinessException(申请不存在或已处理); } // 1. 通过当前申请 apply.setStatus(1); applyMapper.updateById(apply); // 2. 宠物标记为已领养 Pet pet new Pet(); pet.setId(apply.getPetId()); pet.setStatus(2); petMapper.updateById(pet); // 3. 该宠物其他待审核申请自动拒绝 LambdaUpdateWrapperAdoptionApply updateWrapper new LambdaUpdateWrapper(); updateWrapper.eq(AdoptionApply::getPetId, apply.getPetId()) .eq(AdoptionApply::getStatus, 0) .ne(AdoptionApply::getId, applyId) .set(AdoptionApply::getStatus, 2); applyMapper.update(null, updateWrapper); return true; }这段代码量不大但信息密度很高。事务保证了“申请通过、宠物状态变更、其他申请拒绝”这三件事要么全部成功要么全部失败MyBatis-Plus的LambdaQueryWrapper也展示了条件构造器的用法。就这一段已经能撑起答辩时5分钟的深度提问了。3.5 检索、筛选与收藏功能的细节处理首页的宠物列表一般需要一个搜索区域支持按关键词名称/品种、按动物类别、按是否免疫/绝育进行筛选。这里可以用MyBatis-Plus的LambdaQueryWrapper或者直接用Page的分页查询。关键点在“列表数据不要直接返回宠物表全字段”尤其是health_desc这种长文本放在列表接口里纯粹是浪费带宽。建议在实体上使用TableField或自定义VO列表接口只返回id、名称、类别、主图、年龄、是否免疫等核心展示字段详情接口再返回完整信息。收藏功能关注一个细节用户点收藏前要先查询该用户是否已收藏过这只宠物。利用数据库唯一约束兜底插入时捕获DuplicateKeyException这样即使前端连续点了两次也不会产生脏数据。前端拿到返回结果后可以及时切换收藏图标的选中状态交互体验就好了不少。4. 前端核心页面设计要点4.1 前台用户端页面与交互如果采用前后端分离方案前端推荐Vue 2/3 Element UI/Element Plus。首页建议包含几个区域导航栏、顶部轮播图或公告栏、宠物卡片列表带封面图、名称、类别标签、搜索筛选栏。宠物卡片点击进入详情页详情页展示多张图片、基础信息、健康状况描述和“申请领养”按钮。这里有一个很实际的前端问题图片加载失败怎么办。后端返回的图片路径中可能因为服务器迁移、文件被删等原因已经失效。Vue里用error事件统一替换成一张默认占位图是很实用的小技巧。申请领养的表单不要做得过于复杂最好是姓名、电话自动带出然后加手机号、微信号、居住情况、养宠经验、领养理由这几个字段就够了。太多字段会让用户失去耐心太少字段送养人又没法判断这本身就是一个产品设计的权衡。4.2 后台管理页面的布局管理员后台用单独的登录入口页面偏简约即可。侧边栏放用户管理、宠物审核、公告管理、数据统计几个菜单。宠物审核页是最能体现业务功能的页面管理员看到的是“待审核宠物列表”每条数据有“查看详情”“通过”“驳回”三个操作。驳回时必须填原因驳回后该宠物信息被标记为审核失败用户端可见并且在用户“我的发布”里能显示审核失败原因。数据统计页可以放四个大数字卡片用户总数、宠物总数、今日新增申请、领养成功数再放一张按月份统计的柱状图可以用ECharts。这部分代码量不大但页面一出来整个系统马上就显得立体了。5. 常见问题与排查技巧实录每次带项目的时候遇到的问题翻来覆去就那几类这里我整理一个排查表方便你有据可查现象可能原因解法Spring Boot项目启动报Failed to configure a DataSource未配置数据源或MyBatis扫描不到确认application.yml中数据库地址、账号密码主类上注意MapperScan上传图片提示FileSizeLimitExceededException上传文件大小超过Spring默认1MB修改multipart配置调大max-file-size前端图片全部加载失败资源映射未配置实现WebMvcConfigurer中的addResourceHandlers映射磁盘图片目录登录后请求接口一直401请求头没带Authorization或JWT校验失败前端拦截器统一添加请求头后端打印日志检查token解析结果表字段带下划线查询结果却是nullMyBatis-Plus未开启驼峰映射开启map-underscore-to-camel-case或使用TableField映射跨域请求CORS报错前后端分离但未配置跨域在Spring Boot中配置CorsFilter或实现WebMvcConfigurer添加跨域映射Invalid bound statement (not found)Mapper接口的xml路径没对检查resources目录下xml的namespace是否正确mapper-locations是否配置时间字段差8小时数据库连接未指定时区URL上加serverTimezoneAsia/Shanghai5.1 Spring Boot版本与依赖兼容性这是重灾区。我看到太多人因为跟着某个新教程用了Spring Boot 3.x结果发现数据库驱动、MyBatis-Plus、Spring Security等一堆依赖全部需要升级适配卡了好几天。如果你是第一次做完整的Spring Boot项目直接选2.7.x。MyBatis-Plus的版本建议不要用太老的3.4.x有条件用3.5.3以上的它对Spring Boot 2.7的适配比较成熟。如果用了Spring Boot 3请换到MyBatis-Plus 3.5.5以上版本并且记得是mybatis-plus-spring-boot3-starter这个包名。5.2 部署与演示阶段的注意事项毕设答辩那天现场翻车的情况我也见过不少有几个细节值得提前演练提前确认数据库服务已启动账号密码配置正确。每年都有现场数据库连不上的事故。图片上传目录权限问题在Linux服务器上很常见本地Windows没这事但如果用了云服务器部署目录的写权限需要提前检查。演示时一定要把宠物模块、申请流程、管理员审核这几个核心环节的演示顺序理好不要等答辩老师问“你这个领养流程能走通吗”你才现场现点。视频备份的图片和数据库文件拷一份到电脑/网盘不然万一本地环境炸了一切从头开始。6. 论文写作与答辩准备的几条实战经验6.1 论文结构怎么搭不空洞很多人的论文写出来被老师批“像说明书”核心问题在于只写了“功能是什么”没有写“为什么要这样做、怎么实现的、遇到什么问题”。我建议提纲这么排第一章 绪论项目背景。重点写流浪动物问题的社会现状、线下领养的信息不对称痛点最后引出系统的研究意义。第二章 相关技术介绍写Spring Boot的核心机制自动装配原理是很值得展开的点、MyBatis-Plus、Vue、JWT等不要粘贴大段命令要讲清楚你用到的技术分别在项目里承担什么角色。第三章 系统需求分析画用例图、功能模块图、非功能需求安全性、性能、可维护性。第四章 系统设计架构设计、技术架构图、数据库详细设计每个表都要配字段说明表状态流程设计。第五章 系统实现按“功能模块关键代码界面截图功能描述”四件套来组织每个模块至少写2-3页。第六章 系统测试功能测试用例表、测试结果、代表性页面截图。测试部分很多人凑字数其实可以用测试用例表把每个模块的测试步骤、预期结果、实际结果列出来很充实。6.2 答辩现场老师常问的几个问题我总结下来这类题目的答辩问题基本逃不出这几个方向“Spring Boot自动装配是怎么实现的和传统Spring有什么区别”这时候你把SpringBootApplication里的三大注解拆开讲说到EnableAutoConfiguration通过spring.factories加载配置类就能拿个不错的分数。“为什么不直接用传统三层架构里的service里new对象而要用依赖注入”这题是考察IoC的理解用代码举例说明解耦的好处。“你这个图片上传存到了哪里如果服务器重启/换服务器会不会出问题”这题直接答到本地磁盘存储的局限再接一句“我在设计时预留了对象存储的扩展接口”妥妥体现工程视野。“同一只宠物多个领养申请你如何保证不会重复领养”把前面的事务代码搬出来讲一遍即可。“JWT和Session有什么区别为什么选择JWT”从无状态、分布式友好、前后端分离适配等角度答。写在最后以上这些基本就是我带这个题目从0到1完整走一遍的全过程。说实在的这个项目不管你是不是冲着“毕设”来做的它的业务模型都挺能训练人的有认证授权、有状态流转、有事务控制、有文件上传、有权限区分几乎把Spring Boot在实际项目中的主力玩法都过了一遍。要说一个最值得多花时间的点我个人的体会是这个项目最提分的不是代码多花哨而是逻辑闭环。发布-审核-申请-审核确认-状态互斥这条链走通走顺图和代码一起展示现场绝对能聊起来。别把时间全耗在页面样式上把状态机和事务处理透后面论文和答辩都会顺很多。如果你正在做这个题目希望这份笔记能让你省下几天试错时间。代码不是最难的最难的是能自己讲清楚每一处设计背后的原因。从需求开始一砖一瓦把系统搭起来这个过程完成了论文和答辩都只是顺水推舟的事情。