1. 项目概述：基于SpringBoot的宠物领养管理系统
去年帮学弟调试毕业设计时，接触到一个典型的宠物领养管理系统。这类系统在高校计算机专业毕设中出镜率颇高，但真正能把业务逻辑和技术实现结合好的案例并不多见。这个基于SpringBoot的宠物领养平台，本质上是一个具有完整前后端的Web应用，核心解决三个痛点：流浪动物信息数字化管理、领养流程标准化、救助机构运营效率提升。
技术选型上采用经典的Java技术栈：SpringBoot 2.7 + MyBatis-Plus + MySQL 8.0，前端可选Thymeleaf或Vue.js。这种组合既能满足毕业设计的技术深度要求，又保证了项目在有限开发周期内的可实现性。我见过不少同学在这个项目上栽跟头——要么业务逻辑设计得过于复杂难以实现，要么技术栈选得太新导致调试困难。其实把握好"够用就好"的原则，这个系统完全可以在2-3周内跑通核心流程。
2. 核心需求与业务逻辑拆解
2.1 用户角色建模
系统通常需要区分三类用户角色：
- 普通用户：浏览宠物信息、提交领养申请
- 救助站管理员：维护宠物档案、审核申请
- 系统管理员：管理用户权限、处理异常情况
角色权限设计建议采用RBAC模型，通过Spring Security的@PreAuthorize注解实现方法级权限控制。这里有个易错点：很多同学会把权限校验放在前端，这是严重的安全隐患。正确的做法是前后端都要校验，且后端校验必须作为最终防线。
2.2 核心业务流程图解
典型领养流程包含以下状态转换：
code复制待领养 → 申请中 → 初审通过 → 家访完成 → 签订协议 → 领养成功
每个状态变更都需要记录操作人和时间戳，这是毕业答辩时老师最爱追问的审计追踪功能。建议使用MyBatis-Plus的@TableField(fill = FieldFill.INSERT_UPDATE)自动填充这些字段。
2.3 数据库设计要点
核心表结构包括：
- 宠物信息表(pet)：需特别注意医疗记录字段的设计
- 用户表(user)：密码必须加密存储
- 领养记录表(adoption)：包含流程状态字段
- 评论表(comment)：实现领养后评价功能
一个常见的坑是宠物图片存储方案。我不建议直接存BLOB，更好的做法是存储文件路径（七牛云或本地存储）+ 缩略图字段。示例DDL：
sql复制CREATE TABLE `pet` (
`id` bigint NOT NULL AUTO_INCREMENT,
`name` varchar(20) NOT NULL COMMENT '宠物名称',
`cover_url` varchar(255) COMMENT '封面图URL',
`thumb_url` varchar(255) COMMENT '缩略图URL',
`health_status` tinyint DEFAULT 1 COMMENT '健康状态',
`vaccination` json DEFAULT NULL COMMENT '疫苗接种记录',
PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
3. 技术实现关键点
3.1 SpringBoot应用骨架搭建
使用IDEA的Spring Initializr创建项目时，必选的starter包括：
- spring-boot-starter-web
- spring-boot-starter-security
- mybatis-plus-boot-starter
- spring-boot-starter-cache
建议的pom.xml配置技巧：
xml复制<properties>
<java.version>17</java.version>
<spring-boot.version>2.7.18</spring-boot.version>
<mybatis-plus.version>3.5.3.1</mybatis-plus.version>
</properties>
<dependencies>
<!-- 开发环境专用 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-devtools</artifactId>
<scope>runtime</scope>
<optional>true</optional>
</dependency>
<!-- 生产环境需要排除 -->
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<optional>true</optional>
</dependency>
</dependencies>
3.2 前后端交互设计
RESTful API设计规范示例：
java复制@RestController
@RequestMapping("/api/pets")
public class PetController {
@GetMapping("/{id}")
public Result<PetVO> getDetail(@PathVariable Long id) {
// 实现逻辑
}
@PostMapping("/{id}/applications")
@PreAuthorize("hasRole('USER')")
public Result submitApplication(@PathVariable Long id,
@Valid @RequestBody ApplicationDTO dto) {
// 领养申请提交
}
}
参数校验建议使用Hibernate Validator：
java复制@Data
public class ApplicationDTO {
@NotBlank(message = "联系方式不能为空")
@Pattern(regexp = "^1[3-9]\\d{9}$", message = "手机号格式错误")
private String contact;
@Future(message = "预约时间必须是将来")
private LocalDateTime visitTime;
}
3.3 复杂业务逻辑实现
领养审核的状态机实现方案：
java复制@Service
@Transactional
public class AdoptionService {
@Autowired
private StateMachine<AdoptionStatus, AdoptionEvent> stateMachine;
public void processApplication(Long recordId, AdoptionEvent event) {
AdoptionRecord record = getRecord(recordId);
stateMachine.sendEvent(
MessageBuilder.withPayload(event)
.setHeader("record", record)
.build());
}
// 状态转换处理器
@TransactionalEventListener
public void handleStatusChange(StateMachineEvent event) {
// 记录状态变更日志
}
}
4. 典型问题排查实录
4.1 跨域问题解决方案
开发阶段常见CORS错误，推荐配置：
java复制@Configuration
public class WebConfig implements WebMvcConfigurer {
@Override
public void addCorsMappings(CorsRegistry registry) {
registry.addMapping("/**")
.allowedOrigins("*")
.allowedMethods("*")
.maxAge(3600);
}
}
生产环境应该通过Nginx配置：
nginx复制location /api/ {
add_header 'Access-Control-Allow-Origin' '$http_origin';
add_header 'Access-Control-Allow-Methods' 'GET,POST,PUT,DELETE';
add_header 'Access-Control-Allow-Headers' 'Content-Type,Authorization';
}
4.2 MyBatis-Plus踩坑记录
- 分页插件必须配置：
java复制@Configuration
public class MyBatisPlusConfig {
@Bean
public MybatisPlusInterceptor mybatisPlusInterceptor() {
MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
interceptor.addInnerInterceptor(new PaginationInnerInterceptor());
return interceptor;
}
}
- 逻辑删除配置陷阱：
yaml复制mybatis-plus:
global-config:
db-config:
logic-delete-field: deleted # 实体字段名
logic-delete-value: 1
logic-not-delete-value: 0
4.3 文件上传最佳实践
推荐使用Commons FileUpload：
java复制@PostMapping("/upload")
public Result upload(@RequestParam MultipartFile file) {
String filename = UUID.randomUUID() +
FilenameUtils.getExtension(file.getOriginalFilename());
Path path = Paths.get("/upload", filename);
Files.copy(file.getInputStream(), path,
StandardCopyOption.REPLACE_EXISTING);
return Result.success("/static/" + filename);
}
安全防护措施：
- 校验文件MIME类型
- 限制上传文件大小（application.yml）：
yaml复制spring:
servlet:
multipart:
max-file-size: 5MB
max-request-size: 10MB
5. 项目扩展方向
5.1 微信小程序集成
通过uniapp快速生成小程序端：
javascript复制// 获取宠物列表
uni.request({
url: 'https://api.example.com/pets',
success: (res) => {
this.petList = res.data;
}
});
5.2 智能推荐算法
基于用户行为的简单推荐：
java复制public List<Pet> recommendPets(Long userId) {
// 1. 获取用户历史浏览记录
List<Long> viewedIds = viewHistoryService.getViewedPetIds(userId);
// 2. 基于标签相似度计算
return petMapper.selectList(new LambdaQueryWrapper<Pet>()
.in(Pet::getCategory, getFavoriteCategories(viewedIds))
.last("LIMIT 10"));
}
5.3 微服务化改造
SpringCloud Alibaba改造步骤：
- 添加nacos-discovery依赖
- 配置bootstrap.yml：
yaml复制spring:
cloud:
nacos:
discovery:
server-addr: 127.0.0.1:8848
分布式事务处理方案：
java复制@GlobalTransactional
public void crossServiceOperation() {
// 调用多个微服务
}
这个项目最让我感慨的是：很多同学把精力过度放在技术炫技上，却忽视了业务逻辑的严谨性。实际上，把基础的CRUD做好，把状态流转设计清楚，把异常情况考虑周全，这样的毕业设计反而更能获得导师青睐。最后提醒一点：系统安全无小事，至少要做好XSS防护和SQL注入防御，这是答辩时的加分项。