做毕设选纯框架 demo 太单薄选电商秒杀又烂大街宠物领养系统这几年算是 Java Web 类项目里性价比非常高的方向业务模型完整、有用户互动、有审核流程、还能自然地扯到百度地图、文件上传、权限控制这些加分点。如果你手里正好有一套 SpringBoot Vue 的前后端分离宠物领养系统源码配套 SQL 脚本和接口文档那这篇内容就是帮你把这些材料真正“吃透”、能在答辩现场讲明白的实战拆解。我平时接触这类毕设项目比较多也帮人改过不少先说结论这套东西能不能得高分不取决于代码量多大而取决于你懂不懂为什么这么设计。下面我从项目架构、数据库设计、后端接口、前端联调、运行部署到毕设答辩一条线完整过一遍。1. 项目定位与整体架构设计1.1 为什么选 SpringBoot Vue 这套组合宠物领养系统本质是一个典型的管理信息系统核心场景是两个普通用户浏览、申请领养管理员审核、管理数据。这类系统对实时性要求不高对业务状态流转要求明确所以采用前后端分离架构非常合适。后端用 SpringBoot 不是因为它“流行”所以选它而是因为 SpringBoot 自带内嵌 Tomcat一套 Jar 包就能跑起来开发阶段不需要单独装 Tomcat 再配置数据源配合 Spring MVC 处理接口路由、MyBatis 或 MyBatis-Plus 操作数据库三层架构清晰明确答辩时每一层都能说出具体职责。前端用 Vue 的核心原因是组件化开发效率高Element UI 这类组件库直接提供表格、表单、对话框、分页组件写后台管理页面基本是搭积木单页面应用配合 Axios 调接口又非常顺手。这套架构有一个非常实际的优点前端和后端可以独立开发、独立部署。你做毕设的时候完全可以先把后端接口全部测通了再慢慢写前端页面或者反过来先用 Mock 数据把前端画出来再对接真实接口。两条路并行推进比传统 JSP 那种全耦合方式快得多。1.2 三层架构在项目里的落地形态标准的三层架构在这套系统里的映射关系很清晰Controller 层负责接收前端请求、参数校验、调用 Service 层、封装返回值。这一层只做“翻译”和“转发”不写业务逻辑。Service 层业务核心比如领养申请的审批状态流转、用户注册时的唯一性校验、宠物的上下架逻辑都写在这里。事务注解Transactional也加在这一层。Mapper/Dao 层负责数据库操作。MyBatis-Plus 的 BaseMapper 提供了单表 CRUD 方法节省大量重复代码复杂多表查询再手写 XML。前端同样分层页面组件放在 views 目录公共组件放 components接口请求统一封装在 api 模块里工具方法放 utils。我见过不少同学把所有请求直接写在页面文件里接口一多基本没法维护所以规范封装这件事一定要从第一天就做好。1.3 核心功能模块拆解一套完整的宠物领养系统功能上至少要覆盖两个端缺了任何一边业务都跑不通普通用户端注册登录用户名密码注册、登录后返回 Token宠物浏览分页查看待领养宠物列表按类型、性别、年龄筛选宠物详情查看宠物照片、性格描述、健康状况、免疫情况领养申请填写领养申请表单居住情况、养宠经验等提交后进入审核流程个人中心查看自己的申请记录、审核状态、个人信息修改、收藏列表管理员端后台登录管理员账号独立认证宠物管理发布新宠物、编辑宠物信息、下架已领养宠物、上传多张图片领养审核查看用户提交的领养申请审核通过或驳回通过后宠物状态同步改为“已被领养”用户管理查看注册用户列表、启用/禁用账号公告管理发布系统公告更新首页公告栏数据统计统计宠物数量、领养成功数量、注册用户数量用于首页概览卡片这两个端的业务闭环是这样的用户注册 - 浏览宠物 - 提交申请 - 管理员审核 - 审核通过 - 宠物状态变更 - 用户看到结果。每一步都有状态变化每一次变化都有数据记录这个设计在答辩时非常加分因为它体现了完整的业务思考。1.4 技术选型版本与注意事项如果你手里这套源码用的 SpringBoot 版本偏高比如 2.7 或 3.x有几点要特别注意这些也是群里被问烂的问题SpringBoot 2.x 和 3.x 的javax.servlet包名改成了jakarta.servlet如果你网上搜的旧教程导入javax包在 3.x 里直接编译报错。SpringBoot 2.x 一般搭配 Java 8 或 11SpringBoot 3.x 要求 Java 17 起步。先看你 JDK 版本再决定要不要换 SpringBoot 版本这是新手最容易忽略的坑七寸。MyBatis-Plus 的版本也要和 SpringBoot 版本匹配老版本 Plus 在 SpringBoot 3 里会启动失败。前端 Vue 项目如果是 Vue 2 Element UINode 版本建议 14 到 16如果是 Vue 3 Element PlusNode 建议 16 以上。Node 版本太高老项目经常报OpenSSLError这是 nvm 可解的问题。注意拿到源码的第一步不是急着跑起来是先看pom.xml和package.json里锁定的版本对照自己本机环境提前确认兼容性。省得后面前后端联调时被环境问题浪费好几天。2. 数据库设计与 SQL 脚本的落地经验2.1 领着几张核心表搞清楚业务关系一套正规的毕设 SQL 脚本里一般包含 5 到 8 张表我先说最核心的几张你拿到脚本后第一件事就是对着表结构把这些表的关系理清楚。用户表user字段一般包含id、username、password注意是 MD5 或 BCrypt 加密后的密文、phone、email、avatar、role区分普通用户和管理员、status是否被封禁、create_time。这张表是整个系统的基础登录认证、个人信息、领养记录都关联它。宠物表pet字段包含id、name、category猫/狗/其他、gender、age、health_status健康/治疗中/待体检、description、images图片 URL多张可以用逗号分隔或单独一张图片表、status待领养/审核中/已领养、create_time、update_time。这张表的status字段是业务流程的关键开关。领养申请表adoption_apply字段包含id、user_id申请人、pet_id申请领养的宠物、reason申请理由、has_pet_experience养宠经验、address居住地址、status待审核/通过/驳回、create_time、handle_time、admin_remark审核备注。这张表连接了用户和宠物是整个系统业务逻辑最密集的地方。公告表notice、收藏表favorite、图片表pet_image按需使用数量不多但让系统功能更完整。你要做扩展也优先从这几张表入手。2.2 SQL 脚本该有哪些内容才算规范化一套规范的 SQL 脚本不是只扔一个create database和建表语句就完事至少应该包含这几部分建库语句CREATE DATABASE pet_adoption DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;注意字符集用 utf8mb4 才能完整支持 emoji 和特殊符号。建表语句每张表要写清字段注释、主键、索引。id一般用BIGINT自增状态字段用TINYINT或VARCHAR存语义化值都可以但注释必须写清楚每个取值代表什么意思。初始数据至少要有一个管理员账号密码一般是加密后的admin123、几个测试用户、几只不同状态的宠物样本数据、1 到 2 个待审核的领养申请。这些初始数据能让你一跑起来页面就有内容可看不用先手动录一堆数据才能演示功能。外键关系我不建议在物理层加太多外键约束逻辑外键就够了。毕设场景数据库操作比较简单物理外键在删除时反而容易卡住流程写清楚逻辑关联关系配合 Service 层代码控制数据完整性既灵活又不容易出问题。2.3 数据库 code first 还是表驱动设计开始写代码前先设计表这个顺序一定不能反。我见过有同学上来先写实体类然后让 MyBatis-Plus 自动建表最终表字段乱七八糟连注释都没有。数据库是整个项目的基座表设计一旦定下来后端的实体类、XML 映射、前端表单全都要跟着走中途大改非常痛苦。建议你先用 Navicat 或 DBeaver 把 SQL 脚本里的表结构和关系彻底看明白然后用思维导图或表格梳理出“一张表对应哪个页面、哪个接口在操作它”梳理清楚了再动代码。这个“先理表后写码”的习惯在职场上比做毕设更重要。2.4 用 SQL 脚本初始化环境的标准流程拿到pet_adoption.sql后的标准操作流程本地安装 MySQL 5.7 或 8.05.7 对老项目兼容性更好8.0 性能更强都可以。用 Navicat 或命令行执行create database建库。选择刚建的库右键“运行 SQL 文件”选择你的 sql 脚本执行。执行完后检查show tables;看表是否建全select * from user;看初始数据是否导入select * from pet;看测试数据是否正常。把数据库账号密码记下来后面配置application.yml要用。注意如果 SQL 脚本里有中文注释执行时出现乱码多半是连接字符集的问题。连接数据库时在 URL 上加?useUnicodetruecharacterEncodingutf8一般能解决。3. 后端接口设计与核心业务实现3.1 接口文档里的 RESTful 风格约定接口文档是你拿到整套源码后第二重要的东西第一是数据库脚本。一份合格的接口文档应该对每个接口说明清楚请求方法、请求路径、请求参数、返回数据结构、错误码含义。这套项目接口设计一般遵循 RESTful 风格我列几个最常见的示例POST /api/user/register用户注册参数是用户名、密码、手机号POST /api/user/login用户登录返回 Token 和用户基本信息GET /api/pet/list?pageNum1pageSize10分页查询宠物列表GET /api/pet/detail/{id}查看宠物详情POST /api/adoption/apply提交领养申请GET /api/adoption/my查看我的申请记录PUT /api/admin/adoption/audit管理员审核领养申请路径清晰、方法语义正确这套接口文档如果不完整你在前后端对接时就会到处踩坑。建议拿到文档后把每个接口在 Postman 或 Apifox 里跑一遍既能验证接口是否正常工作也能加深你对业务逻辑的理解。有这份实测记录答辩时导师问“这个接口怎么调通的”你就非常有底气。3.2 统一返回体设计前后端协作的第一步一个优秀项目的接口返回值一定是统一格式的而不是有的接口返回一堆字段、有的接口只返回true/false。最常见的统一返回体是{ code: 200, message: 操作成功, data: { } }code状态码200 表示成功非 200 表示失败。可以自定义比如 500 表示服务端异常401 表示未登录403 表示无权限。message提示信息前端可以直接用 message 字段做弹窗提示。data真正的业务数据类型不确定可以是对象、数组、分页结构。前端 Axios 拦截器里统一判断code是否等于 200不是就弹出错误提示。这样后端返回的错误信息能直接展示给用户不用每个接口单独写一遍错误处理逻辑。这就是为什么接口文档里一定要写清楚返回结构前后端各写各的对接时才不会鸡同鸭讲。3.3 登录认证与权限控制的两种主流方案宠物领养系统涉及用户和管理员两种角色接口必须做权限控制不能有任何用户都调管理端接口。目前的源码一般用两种方案之一方案一JWT 拦截器更主流用户登录成功后后端生成一个 Token字符串返回给前端。前端把 Token 存到 localStorage 或 sessionStorage每次请求在请求头带上Authorization: Bearer token。后端写一个拦截器HandlerInterceptor对所有接口除了登录、注册等白名单统一校验 Token 是否有效有效就放行并把用户信息放到请求上下文里无效就返回 401。答辩时你可以这么讲“我们采用了无状态的 JWT 认证方案服务端不需要保存会话信息扩展性好适合前后端分离架构。”方案二Session 认证传统方案用户登录后后端把用户信息存进 Session前端通过 Cookie 自动携带 SessionId 访问。这种方案实现简单但跨域配置麻烦且服务端要维护会话状态更适合非前后端分离的传统项目。我建议你在浏览器开发者工具的 Network 面板看一看登录请求的响应亲眼看下 Token 是怎么返回来、又是怎么被前端存下来的这个过程理解了认证机制这块答辩基本就稳了。3.4 宠物领养核心流程在接口层如何实现整个系统最核心的业务线就是“提交领养申请 - 管理员审核”对应后端接口的实现逻辑大致是提交申请接口用户端拦截器校验用户是否登录获取当前用户 ID。校验宠物 ID 是否存在、宠物状态是否为“待领养”如果宠物已经被申请或已领养直接驳回。创建adoption_apply记录状态设为“待审核”。可选把宠物状态改为“申请中”或“待审核”防止多人同时申请同一只宠物。审核接口管理员端校验当前用户角色是否为管理员。根据申请 ID 查询申请记录和关联宠物信息。如果审核通过将申请记录状态改为“通过”宠物状态改为“已领养”记录处理时间和备注。如果审核驳回将申请记录状态改为“驳回”宠物状态恢复为“待领养”记录驳回原因。整个操作加Transactional事务注解保证多个表的数据变更要么全部成功要么全部回滚。这个流程里“状态机”的思想很重要宠物的状态流转是单向有约束的不是随意改的。把状态字段的含义和流转规则画个图答辩时能展示你的逻辑思维能力。3.5 文件上传与图片处理要注意的坑宠物领养系统需要上传宠物图片这块也是常见扣分点。要注意的问题有上传路径配置不要用绝对路径硬编码比如D:/upload/换一台电脑就挂了。要配置成相对路径或从配置文件读取然后通过虚拟路径映射访问。SpringBoot 里用WebMvcConfigurer的addResourceHandlers方法把本地磁盘路径映射成/images/**访问。图片大小限制spring.servlet.multipart.max-file-size10MB要配好不配的话默认 1MB传一张稍微大点的图片就报错。存储方式毕设场景存本地磁盘就够存数据库 Base64 字段完全不推荐数据库体积膨胀严重。如果想加分可以提一下后续可以改造为阿里云 OSS 或 MinIO。3.6 接口文档里的分页参数到底怎么理解分页查询是后端接口最常用的功能之一很多同学对分页参数搞不清楚。接口文档里的pageNum、pageSize一般是这么用的pageNum页码从 1 开始pageSize每页条数比如 10后端计算offset (pageNum - 1) * pageSize用 MyBatis-Plus 的PageT分页插件或者手写LIMIT #{offset}, #{pageSize}查询。返回结果一般包含total总条数、records当前页数据列表、pages总页数、current当前页数。前端 Element UI 的el-pagination组件会把当前页码和每页条数作为参数传给你的查询接口你只要把后端的返回结构对应好分页功能就通了。分页作为高频接口建议优先调通因为几乎所有列表页面都依赖它。4. 前端 Vue 工程设计与前后端联调4.1 Vue 项目目录结构与职责划分Vue 前端工程拿到手先看 src 目录的组织方式规范的项目一般是这样的结构src/ api/ # 接口请求封装按模块拆文件 user.js pet.js adoption.js assets/ # 静态资源图片、全局样式 components/ # 公共组件比如 UploadImage、Pagination router/ # 路由配置 store/ # Vuex/Pinia 状态管理登录状态、用户信息 utils/ # 工具函数比如 request.js 封装的 Axios 实例 views/ # 页面组件 admin/ PetManage.vue AdoptionAudit.vue user/ PetList.vue PetDetail.vue MyApply.vue Login.vue Register.vue App.vue main.js这个结构不是随便分的每一层职责单一改动一个功能不需要满项目找文件。比如你要改接口地址只需动api目录要改页面样式先去views找对应页面组件。这样的工程组织方式本身就是答辩时的一个展示点。4.2 Axios 封装与请求拦截的核心逻辑前端所有请求都走一个统一封装好的 Axios 实例一般在utils/request.js作用有三统一配置基础地址axios.defaults.baseURL /api或者根据环境变量区分开发环境和生产环境。请求拦截器每次请求发出前从 localStorage 里取 Token加到请求头Authorization。响应拦截器收到响应后统一处理状态码。如果code是 200 就直接返回数据如果是 401 就跳转登录页清掉本地登录信息如果是其他错误码就弹出错误提示。实际在联调中响应拦截器里最常见的坑是请求报错了却看不到任何提示。原因很可能是拦截器处理异常时没有把错误抛回给调用方或者是后端返回结构没有严格按照{code, message, data}格式来。遇到这种情况先在浏览器控制台看具体报错信息再定位是前端封装的锅还是后端接口的锅。4.3 前端路由设计页面跳转与访问控制Vue Router 的页面管理在这套系统里分两个层级公共页面首页、宠物列表、宠物详情、登录、注册所有人都可以访问。需要登录的页面个人中心、我的申请、收藏列表。路由配置里加meta: { requiresAuth: true }配合全局前置守卫拦截未登录用户。管理员专属页面宠物管理、审核管理、用户管理、公告管理。路由守卫中额外检查用户角色不是管理员直接踢回首页。路由守卫的代码逻辑大致是router.beforeEach((to, from, next) { const token localStorage.getItem(token) if (to.meta.requiresAuth !token) { next(/login) } else if (to.meta.requiresAdmin localStorage.getItem(role) ! admin) { next(/) } else { next() } })这套前后端双重权限控制前端控制页面入口后端控制接口访问在设计上是很标准的做法答辩时可以说“我们做了接口层面的权限兜底即使绕过前端页面直接调接口后端也会拦截。”4.4 登录状态管理与用户信息存储登录状态一般用 Vuex 或 Pinia 管理。用户登录成功后后端返回 Token 和用户基本信息前端把 Token 存 localStorage把用户 id、用户名、角色、头像等存 Vuex/Pinia同时刷新时从 localStorage 恢复。这里有一个很多人容易踩的坑直接刷新页面时Vuex 里的状态会清空。所以刷新后要重新根据 Token 调“获取当前用户信息”接口或者把用户基本信息也存在 localStorage。如果你发现明明登录了刷新页面后却显示未登录问题基本就出在这里。4.5 跨域问题的三种解决方案前后端分离开发时前端跑在http://localhost:8080Vue 默认端口后端跑在http://localhost:9090SpringBoot 默认端口不是一个端口就会产生跨域问题。解决跨域的常用方案按照推荐程度排序方案一前端 Vite/Webpack 代理开发环境最推荐在vue.config.js里配置module.exports { devServer: { proxy: { /api: { target: http://localhost:9090, changeOrigin: true } } } }这样前端请求/api/user/login时开发服务器自动把请求转发到http://localhost:9090浏览器觉得是同源请求跨域问题消失而且不需要后端代码任何改动。方案二后端跨域配置生产环境也能用SpringBoot 里写一个配置类实现WebMvcConfigurerOverride public void addCorsMappings(CorsRegistry registry) { registry.addMapping(/**) .allowedOriginPatterns(*) .allowedMethods(GET, POST, PUT, DELETE, OPTIONS) .allowedHeaders(*) .allowCredentials(true) .maxAge(3600); }方案三Nginx 反向代理生产部署把前后端挂在同一个 Nginx 下前端静态文件由 Nginx 直接托管/api路径的请求反向代理到后端服务。生产环境用这种方式最正规打包部署后前端页面和后端接口就同源了不存在跨域。注意如果你用的是方案一打包部署后代理配置是不生效的。所以本地开发用代理线上部署一定要用 Nginx 同源方案这点在做项目演示时不用讲但放到服务器上部署时一定会遇到。4.6 几个前端高频报错与排查思路报错一[Vue warn]: Property xxx was accessed during render but is not defined原因模板里用了data里没有声明的变量或者变量名拼错了。解决去对应组件里检查变量的声明和写法。报错二Cannot read property xxx of undefined原因接口返回的数据结构层级比自己预期的多包了一层或者请求失败返回了undefined。建议先把接口在浏览器 Network 面板里看响应 JSON 到底是什么结构再调整代码取值的路径。报错三404 (Not Found)原因请求路径和后端接口路径不一致。也许路由是/api/pet/list后端接口是/pet/list代理配置又把/api前缀替换掉了一层路径就对不上了。排查方法是先看浏览器请求的完整 URL再对照后端 Controller 的RequestMapping一处处核对。报错四ERR_CONNECTION_REFUSED原因后端服务根本没启动或者端口不对。先确认后端 SpringBoot 是否成功启动看控制台日志再确认前端代理目标端口是否和后端server.port一致。5. 带你从 0 到 1 把整套项目跑起来5.1 环境准备清单在碰项目代码之前先把环境列表理清楚。缺什么装什么版本以项目源码要求为准工具推荐版本用途JDK1.8 或 11SpringBoot 3.x 需 17运行后端Maven3.6.x 或 3.8.x管理后端依赖MySQL5.7 或 8.0数据库Node.js14/16Vue216Vue3运行前端npm/yarn/pnpm随 Node 自带或单独安装前端包管理IDEA2021 以上后端开发工具VSCode最新版前端开发工具在小本本上对照源码要求一项项打勾缺什么装什么省得后面一次次报错再去补环境。5.2 三步跑通后端项目第一步导入数据库用 Navicat 或命令行把 SQL 脚本执行一遍建好库和表确认初始数据导入成功。第二步修改配置文件后端项目的src/main/resources/application.yml或.properties里把数据库连接信息改成你自己的server: port: 9090 spring: datasource: url: jdbc:mysql://localhost:3306/pet_adoption?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: your_password driver-class-name: com.mysql.cj.jdbc.Driver三个东西最容易改错数据库名要和 SQL 脚本建的库名一致serverTimezone不配可能报时区错误密码别带着多余的空格。第三步启动项目IDEA 里打开项目等 Maven 依赖下载完直接运行主类Application或xxxApplication.java。如果一切正常控制台会打印 SpringBoot 的 banner并显示Tomcat started on port(s): 9090。注意依赖下载有可能非常慢。可以在 Maven 的settings.xml里配置阿里云镜像把中央仓库替换成国内地址速度会快很多。5.3 三步跑通前端项目第一步安装依赖在项目目录下打开终端执行npm install如果下载慢用淘宝镜像npm config set registry https://registry.npmmirror.com第二步启动开发服务npm run serveVue CLI 项目默认跑在http://localhost:8080看到 Compiled successfully 就说明成功了。第三步打开页面登录浏览器访问http://localhost:8080用 SQL 脚本里初始化的管理员账号一般是admin/admin123登录管理端再用普通用户测试用户端。如果前端页面能调通后端数据说明整套项目已经跑通了。5.4 打包部署到服务器的完整流程毕设如果需要演示系统可以跑在服务器上打包流程也不难后端打包mvn clean package -DskipTests在target目录下会生成一个 Jar 包上传到服务器后执行java -jar pet-adoption-0.0.1-SNAPSHOT.jar前端打包npm run build生成dist目录把dist里的静态文件放到 Nginx 的html目录然后在 Nginx 配置里加一个反向代理location /api/ { proxy_pass http://127.0.0.1:9090/; }这样访问http://your-server-ip直接就是前端页面/api开头的请求会自动转发到后端 Jar 包。整体部署方案很常规但在毕设里已经是“能上生产”的完整架构了。6. 拿到源码后如何二次开发与答辩加分6.1 基于现有项目做差异化扩展的建议如果你不想整套代码原封不动交差以下扩展方向都是在现有源码基础上可以实现的而且都有明确业务价值流浪动物地图展示集成高德地图或百度地图 JS API在宠物详情页展示发现地点或领养地点。需要给宠物表增加longitude、latitude字段前端引入地图组件。领养协议在线签署审核通过后要求用户在线上确认电子领养协议用 Canvas 或签名组件实现手写签名生成一张带时间戳的协议图片。这个功能很能体现系统完整度。宠物疫苗接种提醒给宠物表增加疫苗到期时间系统定时任务在到期前发送短信或公众号通知。后端用 Spring 的Scheduled定时注解即可前端在个人中心展示提醒列表。数据可视化大屏管理端首页用 ECharts 画总领养量趋势图、宠物类型分布饼图、每周新增用户柱状图。查几张表做聚合统计代码量不大但视觉冲击力很强。图片懒加载与七牛/CDN 接入把宠物列表的图片从本地存储改造为对象存储地址页面加载性能明显提升可以作为“项目优化”讲给导师听。答辩最关键的原则只讲你用过的凡是糊弄上去的功能导师连续追问三个问题就会露馅。所以扩展宁精勿滥自己真正动手实现透彻的功能才写进答辩稿。6.2 用这套项目回答导师常见问题答辩时导师一定会围绕项目问一些深入的问题提前准备以下问题的高质量答案“为什么选前后端分离”答前端关注交互和渲染后端关注业务和数据职责分离独立开发、独立部署、独立扩展后续如果要出小程序或 App 端后端接口可以无缝复用。“Token 过期了怎么办”答用户登录时设置 Token 有效期比如 24 小时前端在请求拦截器里可以判断 Token 是否快过期提前跳转登录页重新登录。更完善的方案是双 Token 机制AccessToken RefreshToken但毕设通常用单 Token 加合理有效期就够了重点是把为什么要这样设计讲清楚。“数据库为什么没加外键”答外键约束会影响写入性能和扩展灵活性尤其在分库分表场景下维护成本高。我们在业务代码层通过事务和数据校验保证数据一致性。这个回答体现你思考过比“模板就是这样”强得多。“如果用户量变大怎么优化”答分三个层面。第一数据库层面热门查询字段加索引列表查询分页优化冷数据归档。第二缓存层面引入 Redis 缓存宠物列表热点数据减少数据库压力。第三部署层面后端多实例部署配合 Nginx 负载均衡前端静态资源上 CDN。不用真的全部实现但能说清思路就已经是加分项。6.3 一个能让系统更稳的小改进接口参数校验很多直接拷贝的源码在参数校验上很薄弱。比如用户提交领养申请时reason字段可能传空字符串注册时用户名可能只传一个空格。要提升代码质量可以引入hibernate-validator参数校验在实体类字段上加注解NotBlank(message 用户名不能为空) Size(min 3, max 20, message 用户名长度需要在3-20之间) private String username;Controller 层参数加Validated注解校验失败时由全局异常处理器统一返回错误信息。这个改进代码量不大但从项目规范度上看比裸参数判断高一个档次。6.4 项目演示时的流程脚本设计答辩演示不是随便点两下页面就完事建议提前设计一条完整的演示主线进入首页展示宠物列表和公告信息。注册一个全新用户演示注册的校验逻辑比如重复用户名提示。用新用户登录浏览宠物详情收藏一只宠物。提交一份领养申请填写完整的申请理由和居住信息。退出登录用管理员账号登录。进入领养审核页面审核刚才提交的那份申请选择通过。切换到用户视角或者解释用户会看到的变化展示宠物状态变为“已领养”、申请状态变为“通过”。最后展示管理端的数据统计页面。这条流程走下来把系统核心功能全串了一遍而且有完整的状态流转闭环自然流畅完全是真实业务操作。7. 常见报错音视频排查速查表与避坑指南最后把容易踩的坑集中整理成一张速查表遇到问题直接按图索骥。问题现象可能原因解决方案Maven 依赖下载慢或下载失败没配国内镜像settings.xml 加阿里云镜像后端启动报Access denied for user数据库账号密码不对检查 application.yml 的 username/password后端启动报Unknown database数据库没创建先执行 SQL 脚本建库后端启动报Port 9090 was already in use端口被占用换端口或用netstat -ano查占用进程前端npm install慢默认 npm 源太慢换成 npmmirror 镜像前端启动报Error: Cannot find module node-sassnode-sass 安装失败换用sass或者升级 Node 版本后重装前端启动报digital envelope routines::unsupportedNode 17 和 Webpack 4 冲突设置环境变量NODE_OPTIONS--openssl-legacy-provider或换 Node 16页面能打开但列表无数据后端没启动/跨域没配好先看 Network 面板请求是否 200登录成功后刷新页面就退出用户信息只存在内存Vuex/Pinia刷新后根据 Token 重新拉取用户信息上传图片失败或图片不显示上传路径配置错误/虚拟映射没配确认本地磁盘有对应目录虚拟映射路径别配错时间显示不正常时区问题JDBC URL 加serverTimezoneAsia/Shanghai再补几个平时容易被忽略的细节修改代码不生效后端改了代码没重启IDEA 里 SpringBoot 项目需要重启才生效。前端改了代码但浏览器缓存CtrlF5 强制刷新。SQL 脚本反复执行报错如果表已经存在先DROP TABLE再重新执行或加IF NOT EXISTS判断。数据库连接池报连接失败MySQL 8.0 的驱动类名是com.mysql.cj.jdbc.Driver5.7 是com.mysql.jdbc.Driver。驱动类名不对项目直接起不来。注意排查问题最高效的路径永远是先看日志。后端问题看 IDEA 控制台堆栈信息前端问题在浏览器按 F12 打开开发者工具先看 Network 面板的请求状态再看 Console 的报错信息。绝大多数问题不用百度日志里已经告诉你怎么查了。说实话SpringBoot Vue 做的管理系统在 Java Web 毕设里数量非常多但真正把代码吃透、能把每一步设计理由讲清楚的人并不多。我见过很多同学拿到一套完整源码草草跑通就以为万事大吉结果答辩时被问“为什么表设计成这样可以”“这个接口事务加在哪一层”就卡壳。上面这套内容核心就是想让你把“会跑”变成“会讲”把“抄作业”变成“真掌握”。我记得自己当年第一次跑通前后端联调看到登录页面跳转到管理后台那一刻那种“全链路被我打通了”的踏实感比背一百道面试题都管用——按这条路径走下来你也一定能体验到。最后再建议一句把数据字典表、接口调用记录、测试账号密码这些平时觉得麻烦不想写的内容通通补进项目文档里等到部署、演示、导师查项目的时候你会感谢自己当初多花了这几个小时。