SpringBoot流浪动物救助平台：从数据库设计到部署全流程

简介：本毕业设计资源围绕基于Spring Boot的流浪动物救助平台，提供完整项目源码、MySQL数据库脚本及配套说明文档，适合计算机相关专业学生用于毕业设计、课程设计或新手项目实践。系统采用Spring Boot + Vue + MySQL技术栈，功能覆盖用户注册登录、流浪动物展示、领养申请、爱心募捐、志愿者申请以及后台信息管理等模块；说明文档按照理论基础、系统分析、数据库设计、功能实现与系统测试的结构展开，包含首页、用户注册、领养申请、爱心募捐、后台管理等界面说明，以及功能、安全、性能测试思路，便于快速理解整体架构和业务闭环。资源包为zip格式，大小34.06MB，平台暂未展示具体文件数量；压缩包内以Java后端源码、Vue前端页面、SQL数据库脚本、Word说明文档等文件为主，目录划分清晰，可按章节和功能模块对照学习。目前已有1535人学习下载，适合需要参考完整前后端项目、了解救助类平台设计思路并在此基础上进行二次开发的开发者。

1. 基于SpringBoot的流浪动物救助平台，毕业设计怎么落地

很多 Java 方向的毕业设计会选“基于SpringBoot的流浪动物救助平台”，因为业务闭环好讲：用户浏览宠物、提交领养申请、志愿者登记救助信息、管理员审核，四类动作搭起完整模块，工作量也正好控制在一个学期内。真正花时间的不是 CRUD 本身，而是三处容易被低估的点：表结构怎么支撑状态流转，图片上传的路径策略怎么选才能换机器不崩，以及源码、数据库脚本、说明文档三件套交付后，别人能不能照着三步跑起来。这篇博文按“设计 → 实现 → 配置 → 部署 → 优化”的顺序，给出一套从零能复现的 Spring Boot 实现方案，新手能照做，熟练工也能看到参数边界和常见坑。

2. 流浪动物救助平台的数据库设计：把表结构定下来

2.1 角色边界：USER、VOLUNTEER、ADMIN 三权分立

平台的角色划分直接决定权限模型复杂度。按最常见的毕业设计方案拆成三个角色：普通用户（USER）负责浏览宠物、提交领养申请、查看申请进度；志愿者（VOLUNTEER）在普通用户基础上增加登记救助记录、更新宠物健康状态的能力；管理员（ADMIN）审核领养申请、管理用户状态、发布公告。规模不大，三张角色表加权限表反而是负担，我一般只用 user 表里的一个role字段，值域就是上面三种，配合 Spring Security 的注解做接口级鉴权。

Controller 方法上直接挂@PreAuthorize("hasRole('VOLUNTEER')")，就是接口级鉴权。这里有个非常容易踩的坑：Spring Security 的hasRole默认会把参数拼接成ROLE_VOLUNTEER再去比较，所以数据库里角色值要么存成ROLE_USER、ROLE_VOLUNTEER、ROLE_ADMIN这种完整写法，要么改用hasAuthority并自己定义权限字符串。很多源码跑不起来，就是角色值少了个ROLE_前缀。权限边界定清楚后，后面写业务代码时只需要关心对象属不属于当前操作者，不需要在 Service 里重复判断角色。

2.2 核心业务表：宠物、申请、救助、公告各司其职

核心表是五张：用户表 user、宠物表 pet、领养申请表 adoption_apply、救助记录表 rescue_record、公告表 notice。再补一张字典配置表 dict_item，用来放“物种”“疫苗状态”“领养状态”这些下拉选项的显示名。前端所有下拉选项都查这一张表，后续加一个宠物类别不需要重新发前端，只改数据就行。论文里可以写“系统具备参数化配置能力”，实际演示时给评委现场加一个下拉项，效果比口头讲好很多。

pet 表是整个平台的主资源，其中status字段需要建模成流转方向而不是简单枚举：

CREATE TABLE pet ( id BIGINT PRIMARY KEY AUTO_INCREMENT COMMENT '宠物ID', name VARCHAR(50) NOT NULL COMMENT '宠物名称', species TINYINT NOT NULL COMMENT '物种：1-猫 2-狗', gender TINYINT DEFAULT 0 COMMENT '性别：0-未知 1-公 2-母', age_month INT DEFAULT 0 COMMENT '年龄（月）', health_status VARCHAR(100) COMMENT '健康状态描述', status TINYINT NOT NULL DEFAULT 1 COMMENT '状态：1-待领养 2-审核中 3-已领养 4-已下架', cover_url VARCHAR(255) COMMENT '封面图相对路径', created_by BIGINT NOT NULL COMMENT '登记人ID', deleted TINYINT NOT NULL DEFAULT 0 COMMENT '逻辑删除标记', create_time DATETIME DEFAULT CURRENT_TIMESTAMP, update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, INDEX idx_status (status), INDEX idx_created_by (created_by) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='宠物信息表';

cover_url存相对路径，例如/upload/xxx.jpg，前端展示时拼后端地址，换服务器换端口不会失效。created_by指向登记人用户 ID。索引只加了idx_status和idx_created_by两条，分别对应首页按状态筛选和“我登记的宠物”两个高频查询路径，再加基本都是浪费。字段命名统一用下划线风格，MyBatis-Plus 开启map-underscore-to-camel-case后，create_time自动映射成实体的createTime，省掉大段@TableField注解。

adoption_apply 表是申请业务的落点。它同时关联 user_id 和 pet_id，并且有一个用户不能对同一只宠物重复申请的约束：

CREATE TABLE adoption_apply ( id BIGINT PRIMARY KEY AUTO_INCREMENT, user_id BIGINT NOT NULL COMMENT '申请人ID', pet_id BIGINT NOT NULL COMMENT '宠物ID', apply_status TINYINT NOT NULL DEFAULT 1 COMMENT '1-待审核 2-已通过 3-已拒绝 4-已取消', reason VARCHAR(500) COMMENT '申请说明', create_time DATETIME DEFAULT CURRENT_TIMESTAMP, INDEX idx_user (user_id), INDEX idx_pet (pet_id), UNIQUE KEY uk_user_pet (user_id, pet_id) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='领养申请表';

uk_user_pet这个逻辑很值得保留：数据库层面拦截重复申请，比 Service 里先 select 再 insert 可靠得多，并发下也不会出问题，答辩时是明确的加分点。物理外键不建议建，原因有两个：一是每次插入都要检查父表，演示数据量下感受不到约束的必要；二是外键让一对多删除变得很麻烦，比如删除宠物时要额外处理申请记录。逻辑外键字段加注释说明即可，论文 ER 图照画关系线，和表结构不冲突。

2.3 初始化脚本的幂等策略

说明文档里的 sql/init.sql 必须能反复执行不报错。统一写法是每个 CREATE TABLE 之前先DROP TABLE IF EXISTS，这就是演示数据的一键重置开关。开头写CREATE DATABASE IF NOT EXISTS rescue和USE rescue，用户拿到脚本后先执行这引导两句，就不用手动建库。字符集全部用 utf8mb4，排序规则用utf8mb4_general_ci，和 Navicat 默认选项对齐，导入导出不出现乱码。

3. 基于SpringBoot的分层实现：Controller、Service、Mapper

3.1 项目分包和依赖版本选型

分包按com.example.rescue根包，下面分成 controller、service、mapper、entity、config、common。依赖方向是单向的：Controller 依赖 Service，Service 依赖 Mapper，entity 被各层共用，common 放统一返回类和异常处理。谁都不许反向依赖，这是分层唯一的硬规矩。刚起步的同学经常为了省事在 Controller 里直接注入 Mapper，短代码量时没问题，等加了权限、事务、日志之后，Service 层没有落点，代码会乱得很快。

版本选择上，建议 Spring Boot 2.7.x 配 Java 8。这个组合兼容 MyBatis-Plus 3.5.x 和 MySQL 8.0 驱动，网上能找到的大多数示例代码可以直接跑。Spring Boot 3.x 需要 Java 17，并且javax.servlet改成了jakarta.servlet，老代码里的import javax.servlet.http.HttpServletRequest在 3.x 下编译不通过。如果指导老师没有限定必须用最新版，没必要为版本新去折腾迁移。答辩时按“稳定路线选型”来解释版本，反而是加分表述。

统一返回结构类不建议省，它能让前端只处理一种响应：

@Data public class Result<T> { private int code; private String message; private T data; public static <T> Result<T> ok(T data) { Result<T> r = new Result<>(); r.setCode(200); r.setMessage("success"); r.setData(data); return r; } public static <T> Result<T> fail(int code, String message) { Result<T> r = new Result<>(); r.setCode(code); r.setMessage(message); return r; } }

所有接口返回值统一成Result<T>，前端 axios 拦截器只判断code === 200和message两个字段。如果没有统一结构，有的接口返回 Map，有的返回实体，有的直接返回 String，前端写到最后只能逐个接口适配，等于把后端设计的混乱传导到前端。Result类本身的code字段承载业务状态，HTTP 状态码只表达传输层面的成功失败，这是前后端协作的基础共识。

3.2 领养申请状态机：用枚举把 if-else 收进去

领养申请有四种状态：待审核（PENDING）、已通过（APPROVED）、已拒绝（REJECTED）、已取消（CANCELLED）。最差的写法是 Service 里散落一堆if (status == 1 && action == 2)的判断，后边要加一个退回动作，所有地方都要补。更好的做法是把状态流转规则收进枚举，每个状态只回答一个问题“我能变成谁”：

public enum ApplyState { PENDING(1, "待审核") { @Override public boolean canTransitTo(ApplyState target) { return target == APPROVED || target == REJECTED; } }, APPROVED(2, "已通过") { @Override public boolean canTransitTo(ApplyState target) { return target == CANCELLED; } }, REJECTED(3, "已拒绝") { @Override public boolean canTransitTo(ApplyState target) { return target == PENDING; } }, CANCELLED(4, "已取消") { @Override public boolean canTransitTo(ApplyState target) { return false; } }; private final int code; private final String desc; ApplyState(int code, String desc) { this.code = code; this.desc = desc; } public abstract boolean canTransitTo(ApplyState target); }

这里的关键是PENDING只允许去APPROVED或REJECTED，APPROVED只允许去CANCELLED，没有任何一个状态允许无条件跳跃。业务上“已通过的申请要回到待审核”需要通过“取消”再“重新提交”完成，流程上说得通，代码上也堵住了非法路径。

Service 层处理状态更新时套一层事务：

@Transactional public void auditApply(Long applyId, boolean pass, Long operatorId) { AdoptionApply apply = getById(applyId); ApplyState target = pass ? ApplyState.APPROVED : ApplyState.REJECTED; ApplyState current = ApplyState.of(apply.getApplyStatus()); if (!current.canTransitTo(target)) { throw new BusinessException("非法的状态流转:" + current.desc + " -> " + target.desc); } apply.setApplyStatus(target.getCode()); updateById(apply); if (target == ApplyState.APPROVED) { petService.markAdopted(apply.getPetId()); } else { petService.markAvailable(apply.getPetId()); } }

@Transactional必须加在方法外层，让“改申请状态”和“改宠物状态”变成原子操作。最典型的失败场景是申请改成已通过，但宠物没改成已领养，两边数据对不上。事务回滚后两个状态都不会变，也就不会产生脏数据。markAdopted和markAvailable是 petService 里的两个小方法，只更新 pet 表的 status 字段，逻辑简单但和申请状态变化强关联，必须放在同一个事务里。

3.3 多条件筛选与分页：MyBatis-Plus 的写法

首页宠物列表需要按关键词、物种、状态筛选，分页返回。MyBatis-Plus 的 LambdaQueryWrapper 能一次把三个条件都写出来：

public Page<PetVO> pagePets(int pageNum, int pageSize, String keyword, Integer species, Integer status) { Page<Pet> page = new Page<>(pageNum, pageSize); LambdaQueryWrapper<Pet> wrapper = Wrappers.lambdaQuery(Pet.class) .eq(species != null, Pet::getSpecies, species) .eq(status != null, Pet::getStatus, status) .like(StringUtils.hasText(keyword), Pet::getName, keyword) .orderByDesc(Pet::getCreateTime); return petMapper.selectPage(page, wrapper).convert(PetVO::new); }

eq的第一个布尔参数是“这个条件是否生效”的开关，species为 null 时该条件自动忽略，不需要写多层 if 嵌套。关键词用like匹配宠物名称，演示数据量级下不会被索引失效影响。分页返回时用.convert(PetVO::new)把实体转成视图对象，避免把deleted这类内部字段直接暴露给前端。

分页拦截器不是白来的，必须注册：

@Configuration public class MybatisPlusConfig { @Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL)); return interceptor; } }

没有这个 Bean 时selectPage不会报错，但 Page 里的 records 是全部数据，total 是总数，分页完全不生效。最直接的验证方法看控制台日志：分页生效时一条 select 语句带LIMIT ?，一条 select 是 count 查询；如果只有一条不带 limit 的 select，说明拦截器没注册成功。这种故障不报错，只表现为接口越来越慢，排查顺序应该先看日志再怀疑数据库。

接口设计上，按“资源路径 + 动作”集中在一张表里即可：

4. Spring Boot 登录鉴权、图片上传与配置文件调优

4.1 用 JWT 做无状态认证，拦截器校验

毕业设计规模用 Session 完全够，但 JWT 更常见，论文里也能多写一段“无状态认证”的内容。实现上用 jjwt 库，签发和解析两个方法封进 JwtUtil。生成 token 时给足过期时间，24 小时刚好覆盖答辩演示周期：

public String generateToken(Long userId, String role) { return Jwts.builder() .setSubject(String.valueOf(userId)) .claim("role", role) .setIssuedAt(new Date()) .setExpiration(new Date(System.currentTimeMillis() + 24 * 3600 * 1000L)) .signWith(Keys.hmacShaKeyFor(SECRET_KEY.getBytes()), SignatureAlgorithm.HS256) .compact(); }

SECRET_KEY要超过 256 位，也就是至少 32 个字节，新版 jjwt 库对密钥长度有强校验，太短会直接抛异常。token 的 payload 只是 Base64URL 编码，不是加密，任何人都能解码看内容，所以只放 userId 和 role，密码、手机号一律不放。解析 token 时注意 API 版本差异，0.11.x 用parserBuilder：

public Long getCurrentUserId(String token) { Claims claims = Jwts.parserBuilder() .setSigningKey(SECRET_KEY.getBytes()) .build() .parseClaimsJws(token) .getBody(); return Long.valueOf(claims.getSubject()); }

网上很多老文章用setSigningKey直接放字符串，在 0.11.x 以后的版本里编译不过。拦截器负责从Authorization头取出 token，校验通过后把 userId 放进 Request 属性，Controller 不需要每个方法都传 token 参数。

4.2 图片上传：本地存储、UUID 重命名、虚拟路径映射

宠物图片上传推荐本地磁盘方案，不引对象存储服务，毕业设计阶段最省事。配置上传大小上限后，处理文件保存：

String ext = StringUtils.getFilenameExtension(file.getOriginalFilename()); String fileName = UUID.randomUUID().toString().replace("-", "") + "." + ext; file.transferTo(new File(uploadDir, fileName));

UUID 重命名解决两个问题：中文文件名在某些浏览器里乱码，同名文件互相覆盖。uploadDir指向项目运行目录下的 upload 文件夹，启动时不存在就自动创建。transferTo如果跨文件系统移动会报错，Windows 下 C 盘到 D 盘就会触发，所有需要把临时目录和上传目录放在同一分区下，这一点在部署到 Linux 服务器时尤其要注意。

磁盘目录通过虚拟映射暴露成 URL：

@Configuration public class WebConfig implements WebMvcConfigurer { @Override public void addResourceHandlers(ResourceHandlerRegistry registry) { String uploadPath = System.getProperty("user.dir") + "/upload/"; registry.addResourceHandler("/upload/**") .addResourceLocations("file:" + uploadPath); } }

数据库里存/upload/xxx.jpg相对路径，前端展示时拼后端地址。千万不要在数据库里存http://localhost:8080/upload/xxx.jpg这种绝对地址，换端口换服务器后图片全部打不开。这个细节在换电脑跑源码时立竿见影，也是评委爱问的点。

4.3 application.yml 的配置速查与多环境 profile

配置文件把坑提前填平，源码交付别人才能开箱即用。核心配置项集中在下几个块：

server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/rescue?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai username: root password: 123456 servlet: multipart: max-file-size: 5MB max-request-size: 10MB jackson: date-format: yyyy-MM-dd HH:mm:ss time-zone: GMT+8 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

连接串里的serverTimezone=Asia/Shanghai和 Jackson 的time-zone: GMT+8是防止时间差 8 小时的双保险。logic-delete-field: deleted开启逻辑删除后，deleteById自动变成update deleted=1，查询语句自动追加deleted=0。演示数据误删后还能恢复，论文里可以写“数据可追溯，删除采用逻辑标记”，比物理删除体面得多。

数据库密码和 JWT 密钥不要裸写在 application.yml。常见做法是把本机真实配置放application-local.yml，主配置里留占位符，启动参数指定--spring.profiles.active=local。源码交付时默认走 local profile 能跑通，同时论文里注明这是本地演示配置，不是生产标准，评委反而觉得你有环境隔离意识。

5. 源码交付：打包准备、运行验证与高频排错

5.1 三步跑通：SQL 初始化、Maven 打包、java -jar

毕业设计的演示机器往往和开发机不是同一台。最好在说明文档里给出可直接粘贴的三条命令，不依赖 IDE 也能跑起来：

mysql -uroot -p < sql/init.sql mvn clean package -DskipTests java -jar target/rescue-0.0.1-SNAPSHOT.jar

第一条命令把建库建表和演示数据一次性灌入。init.sql 开头要写CREATE DATABASE IF NOT EXISTS rescue和USE rescue，否则用户得手动建库。第二条命令中-DskipTests跳过测试执行，如果项目里测试类有编译错误，还是会被卡住，这时改成-Dmaven.test.skip=true跳过测试编译。第三条命令启动后，日志出现Started Application in xx seconds就说明后端存活。

端口没写死。默认 8080 被占用时，用--server.port=8081启动参数覆盖，不用改配置：

java -jar target/rescue-0.0.1-SNAPSHOT.jar --server.port=8081

5.2 三个高频错误的日志特征和处理顺序

把最容易卡住启动过程的错误整理成对照表，排查时先看 Caused by 那一行，不要从头扫日志：

Windows 下查看端口占用用netstat -ano | findstr 8080，拿到 PID 后到任务管理器结束进程；Linux 下用ss -lntp | grep 8080。数据库连不上时先telnet 127.0.0.1 3306确认端口通，再回头检查连接串。多 profile 配置最容易出现的错误是启动参数还在指 local，但连接串改在 dev 文件里，日志里 Caused by 报的 URL 反而能帮你定位是哪个环境生效。

时间差 8 小时的问题经常被忽视，现象是插入记录后数据库时间和本机时间对不上。统一三个地方：JDBC 连接串的serverTimezone、Jackson 的time-zone、MySQL 的全局时区。临时开会话时区用两条 SQL：

SET GLOBAL time_zone = '+08:00'; SET time_zone = '+08:00';

永久生效需要改 MySQL 配置文件的default-time-zone并重启服务。毕业设计演示环境跑会话级就够了，论文里写明白原理即可。

5.3 用 curl 完成最小链路自测

交付前用 curl 验证登录和鉴权链路，比打开浏览器更快更可信：

curl -X POST http://localhost:8080/api/auth/login \ -H "Content-Type: application/json" \ -d '{"username":"admin","password":"123456"}'

返回值 JSON 里取data.token，拼到宠物列表接口上：

curl http://localhost:8080/api/pets?page=1&size=10 \ -H "Authorization: Bearer <token>"

第二个命令返回 JSON 而不是 401，说明登录、JWT 校验、分页查询链路是通的。Bearer与 token 之间有一个空格，大小写保持Bearer标准写法。这套方法写进说明文档，验收时当评委面敲一遍，比前端页面逐屏演示更能体现工程素养。

6. 基于SpringBoot救助平台的答辩优化：缓存、论文表述与验收自检

6.1 给热点列表接口加一层 Redis 缓存

答辩前补一处性能优化，首选给首页宠物列表和公告列表加 Redis 缓存。查询先取缓存，未命中再查库并写回，缓存 key 按筛选条件拼接，过期时间设 5 分钟。核心是状态变更时的缓存失效逻辑，单独封装一个方法：

public void evictPetListCache() { Set<String> keys = redisTemplate.keys("pets:list:*"); if (keys != null && !keys.isEmpty()) { redisTemplate.delete(keys); } }

redisTemplate.keys("pets:list:*")按前缀匹配出所有列表缓存，审核通过一只宠物后调用该方法，首页列表立即反映新状态。RedisTemplate 需要配置序列化器，推荐GenericJackson2JsonRedisSerializer，否则中文会以乱码形式存入 Redis。缓存逻辑放在 Service 层，Controller 层代码保持干净，论文里可以写“热点查询通过缓存降低数据库压力”，评审看到的是模块间的解耦。

6.2 论文中数据库设计和状态流转怎么写

毕业论文不需要贴全部源码，重点是三处：角色权限表格、状态流转规则、索引设计依据。状态流转用“待审核 → 已通过 → 已领养”箭头描述，配一张表列出每个状态允许的下一个状态，评委一眼看到业务规则理解到位。数据库设计章节说明联合索引uk_user_pet的唯一约束依据，和代码里的状态机限制呼应，形成完整的业务闭环描述。

6.3 验收时的优先自检清单

答辩时间有限，优先演示三件事：登录后拿到 JWT、领养申请状态流转包含非法流转被拦截、上传图片后 URL 能在浏览器直接打开。这三项对应鉴权、业务建模、文件存储三项核心能力。提交申请前再验证一次重复申请被阻止，数据库唯一索引或exists查询都行，这个提问频率非常高。

本文还有配套的精品资源，点击获取