当前位置：首页 > news >正文

宠物综合服务系统毕业设计：从需求分析到高内聚低耦合架构实战

news 2026/5/12 14:34:12

最近在辅导几位学弟学妹做毕业设计，发现一个挺普遍的现象：大家选题时雄心勃勃，想做个“大而全”的系统，比如宠物综合服务系统，但实际开发起来，往往变成了功能的简单堆砌。前端页面和后端接口强耦合，业务逻辑散落在各个角落，数据库设计也缺乏规划，最后答辩时被老师一句“你这不就是个增删改查吗？”问得哑口无言。

今天，我就结合一个实战项目——“宠物综合服务系统”，来聊聊如何从零开始，构建一个结构清晰、可维护性强的毕业设计。我们采用的技术栈是 Spring Boot + MyBatis-Plus + Vue 3，这套组合在中小型项目中非常高效。

1. 痛点分析与技术选型：为什么是它们？

在做毕设时，我们常遇到几个坑：

功能冗余：为了显得“功能丰富”，盲目添加不相关的模块，导致系统臃肿，核心逻辑不突出。
前后端耦合：JSP 时代的思想残留，把大量逻辑写在页面里，或者后端接口返回整个 HTML 片段，前后端分离不彻底。
缺乏异常处理：全局异常处理没做，代码里到处都是try-catch，错误信息直接抛给前端，用户体验差。
“面条式”代码：所有业务逻辑都写在 Controller 或 Service 的一个方法里，可读性和可维护性极差。

针对这些痛点，我们做了如下技术选型：

后端：Spring Boot vs Django/FlaskSpring Boot 的“约定大于配置”理念，能让我们快速搭建起一个结构规范的后端服务。其强大的生态（Spring Security, Spring Data JPA等）和清晰的 MVC 分层，非常适合需要展示规范工程结构的毕设。相比之下，Django 虽然开发更快（自带Admin），但“全家桶”风格有时会隐藏底层细节，不利于展示对 Web 原理的理解。Flask 则过于灵活，对初学者来说，容易写出结构松散的项目。
前端：Vue 3 vs ReactVue 3 的组合式 API 和单文件组件（.vue）对于业务逻辑清晰的中后台管理系统非常友好。其响应式系统上手简单，生态（如 Element Plus）成熟，能快速搭建美观的界面。React 更灵活、生态更大，但 JSX 和函数式编程的思想需要一定学习成本。对于以展示业务实现为主的毕设，Vue 的“渐进式”和模板语法更容易让答辩老师理解你的前端逻辑。
持久层：MyBatis-Plus它是在 MyBatis 基础上的增强工具，提供了通用的 CRUD 方法，避免了大量简单 SQL 的编写，同时保留了 MyBatis 自定义复杂 SQL 的灵活性。这对于需要快速开发，又可能涉及复杂查询（如预约时间冲突校验）的宠物系统来说，是效率与可控性的平衡。

2. 核心架构与模块设计：高内聚，低耦合

我们采用一种简化的领域驱动设计（DDD）思想来划分模块，核心是围绕“业务领域”而非“技术层次”来组织代码。

系统架构（文字描述）：整个系统在逻辑上分为四层：

表现层（Presentation Layer）：Vue 3 前端项目，通过 Axios 调用 RESTful API。
应用层（Application Layer）：Spring Boot 的 Controller，负责接收请求、校验参数、调用领域服务、组装返回结果。这里不写业务逻辑。
领域层（Domain Layer）：这是核心。我们根据宠物业务划分了多个领域模块：
- user(用户中心)
- pet(宠物档案)
- boarding(寄养服务)
- grooming(美容预约)
- health(健康记录) 每个模块内包含自己的 Entity（实体）、Service（领域服务）、Repository（仓储接口）。模块之间通过服务接口进行调用，避免直接依赖实现类。
基础设施层（Infrastructure Layer）：包含数据库（MySQL）、文件存储（OSS/MinIO）、缓存（Redis）、消息队列等外部组件的具体实现。MyBatis-Plus 的 Mapper 实现就在这里。

关键模块实战代码示例：

a. 预约调度模块（幂等性设计）宠物美容预约要防止用户重复提交或同一时间段被重复预约。

// GroomingAppointmentService.java @Service @Slf4j public class GroomingAppointmentServiceImpl implements GroomingAppointmentService { @Autowired private RedisTemplate<String, String> redisTemplate; @Override @Transactional(rollbackFor = Exception.class) public ApiResult createAppointment(AppointmentDTO dto, Long userId) { // 1. 幂等性校验：利用唯一请求ID（可由前端生成） String requestId = dto.getRequestId(); if (StringUtils.hasText(requestId)) { String key = "appointment:req:" + requestId; Boolean success = redisTemplate.opsForValue().setIfAbsent(key, "PROCESSING", 5, TimeUnit.MINUTES); if (Boolean.FALSE.equals(success)) { log.warn("重复的预约请求，requestId: {}", requestId); return ApiResult.fail("请勿重复提交"); } } // 2. 业务校验：时间冲突检查（核心逻辑在领域服务内） if (isTimeSlotConflict(dto.getGroomerId(), dto.getStartTime(), dto.getEndTime())) { throw new BusinessException("该时间段已被预约"); } // 3. 创建预约实体并保存 GroomingAppointment appointment = new GroomingAppointment(); // ... 属性填充 appointment.setUserId(userId); appointment.setStatus(AppointmentStatus.BOOKED); save(appointment); // 4. 可选：清理幂等键，或等待自然过期 // redisTemplate.delete(key); return ApiResult.success("预约成功", appointment.getId()); } // 时间冲突检查方法（应放在领域服务或独立的Domain Service中） private boolean isTimeSlotConflict(Long groomerId, LocalDateTime start, LocalDateTime end) { // 使用MyBatis-Plus的Wrapper构造查询 LambdaQueryWrapper<GroomingAppointment> wrapper = Wrappers.lambdaQuery(); wrapper.eq(GroomingAppointment::getGroomerId, groomerId) .eq(GroomingAppointment::getStatus, AppointmentStatus.BOOKED) .and(w -> w.between(GroomingAppointment::getStartTime, start, end) .or() .between(GroomingAppointment::getEndTime, start, end) .or(q -> q.le(GroomingAppointment::getStartTime, start) .ge(GroomingAppointment::getEndTime, end)) ); return count(wrapper) > 0; } }

b. 用户鉴权与安全实践使用 JWT 进行无状态认证，并注意令牌刷新机制。

// JwtTokenUtil.java 工具类 @Component public class JwtTokenUtil { private String secret = "your-secret-key-change-in-production"; private Long expiration = 7200L; // 2小时 private Long refreshExpiration = 604800L; // 7天 public String generateToken(UserDetails userDetails) { Map<String, Object> claims = new HashMap<>(); claims.put("sub", userDetails.getUsername()); claims.put("created", new Date()); claims.put("type", "access"); // 区分token类型 return doGenerateToken(claims, userDetails.getUsername()); } public String generateRefreshToken(UserDetails userDetails) { Map<String, Object> claims = new HashMap<>(); claims.put("sub", userDetails.getUsername()); claims.put("created", new Date()); claims.put("type", "refresh"); return doGenerateToken(claims, userDetails.getUsername(), refreshExpiration); } private String doGenerateToken(Map<String, Object> claims, String subject, Long customExpiration) { // ... JWT构建逻辑 } // 验证token，并检查类型 public Boolean validateToken(String token, UserDetails userDetails, String expectedType) { final String username = getUsernameFromToken(token); final String type = getClaimFromToken(token, "type", String.class); return (username.equals(userDetails.getUsername()) && !isTokenExpired(token) && expectedType.equals(type)); } } // 在登录接口中 public ApiResult login(LoginDTO dto) { // ... 验证用户名密码 UserDetails userDetails = userService.loadUserByUsername(dto.getUsername()); String accessToken = jwtTokenUtil.generateToken(userDetails); String refreshToken = jwtTokenUtil.generateRefreshToken(userDetails); // 将refreshToken关联用户ID存入Redis或数据库，设置过期时间 redisTemplate.opsForValue().set("refresh:" + userDetails.getUsername(), refreshToken, 7, TimeUnit.DAYS); return ApiResult.success("登录成功", new TokenPair(accessToken, refreshToken)); }

c. 文件上传（宠物图片）防止恶意文件上传，并进行安全过滤。

// FileController.java @RestController @RequestMapping("/api/file") public class FileController { @PostMapping("/upload") public ApiResult uploadFile(@RequestParam("file") MultipartFile file) { // 1. 校验文件大小、类型 long maxSize = 5 * 1024 * 1024; // 5MB if (file.getSize() > maxSize) { return ApiResult.fail("文件大小不能超过5MB"); } String originalFilename = file.getOriginalFilename(); String suffix = originalFilename.substring(originalFilename.lastIndexOf(".")).toLowerCase(); List<String> allowedSuffix = Arrays.asList(".jpg", ".jpeg", ".png", ".gif"); if (!allowedSuffix.contains(suffix)) { return ApiResult.fail("仅支持图片格式"); } // 2. 防止XSS：对文件名进行过滤（简单示例） String safeFileName = originalFilename.replaceAll("[^a-zA-Z0-9.\\-]", "_"); // 3. 生成唯一存储路径（避免覆盖） String filePath = "pet_images/" + UUID.randomUUID() + suffix; // 4. 上传到OSS或本地存储 try { // 这里以本地存储为例 File dest = new File("/your/upload/path/" + filePath); file.transferTo(dest); // 返回可访问的URL String accessUrl = "/static/" + filePath; return ApiResult.success("上传成功", accessUrl); } catch (IOException e) { log.error("文件上传失败", e); return ApiResult.fail("上传失败"); } } }

3. 性能与安全考量：让系统更健壮

性能优化：N+1 查询问题在查询宠物列表及其健康记录时，容易写出 N+1 查询。

// 错误示例：在循环中查询关联数据 List<Pet> pets = petMapper.selectList(null); for (Pet pet : pets) { List<HealthRecord> records = healthRecordMapper.selectList( Wrappers.<HealthRecord>lambdaQuery().eq(HealthRecord::getPetId, pet.getId()) ); pet.setHealthRecords(records); }

优化方案：使用 MyBatis-Plus 的关联查询或手动编写连表 SQL。

// 方案一：在Mapper.xml中编写连表查询（推荐，控制力强） // PetMapper.xml <select id="selectPetWithHealthRecords" resultMap="PetWithRecordsMap"> SELECT p.*, hr.id as hr_id, hr.check_date, hr.symptom, hr.diagnosis FROM pet p LEFT JOIN health_record hr ON p.id = hr.pet_id WHERE p.user_id = #{userId} </select> // 方案二：使用 MyBatis-Plus 的 @TableField(select = false) 和自定义查询方法 // 在Pet实体类中 @Data @TableName("pet") public class Pet { // ... 其他字段 @TableField(exist = false) private List<HealthRecord> healthRecords; } // 在Service中，分两次查询，但使用`in`语句，将 N+1 优化为 1+1 List<Pet> pets = petMapper.selectList(Wrappers.<Pet>lambdaQuery().eq(Pet::getUserId, userId)); List<Long> petIds = pets.stream().map(Pet::getId).collect(Collectors.toList()); if (!petIds.isEmpty()) { Map<Long, List<HealthRecord>> recordMap = healthRecordMapper .selectList(Wrappers.<HealthRecord>lambdaQuery().in(HealthRecord::getPetId, petIds)) .stream() .collect(Collectors.groupingBy(HealthRecord::getPetId)); pets.forEach(pet -> pet.setHealthRecords(recordMap.getOrDefault(pet.getId(), Collections.emptyList()))); }

安全加固：

XSS 过滤：除了在前端 Vue 中使用v-html时谨慎，后端在接收可能包含 HTML 的内容（如用户评价）时，应使用工具类进行转义，如HtmlUtils.htmlEscape。
SQL 注入：坚持使用 MyBatis-Plus 的 Wrapper 或#{}预编译，绝不拼接 SQL 字符串。
接口防刷：对登录、预约等关键接口，使用 Redis 记录 IP 或用户短时间内的请求次数。

4. 生产环境避坑指南

数据库冷启动初始化：在application.yml中配置spring.sql.init.mode=always并准备schema.sql和data.sql文件，方便在全新的环境（如答辩现场的电脑）一键初始化数据库结构和基础数据（如管理员账号、服务类型）。

跨域配置陷阱：开发时前端localhost:8080调用后端localhost:8081会遇到跨域。不要在 Controller 上加@CrossOrigin，而是使用全局配置。

@Configuration public class CorsConfig implements WebMvcConfigurer { @Override public void addCorsMappings(CorsRegistry registry) { registry.addMapping("/api/**") // 只针对API接口 .allowedOriginPatterns("*") // 生产环境应替换为具体前端地址 .allowedMethods("GET", "POST", "PUT", "DELETE", "OPTIONS") .allowCredentials(true) .maxAge(3600); } }

注意：如果使用了 Spring Security，还需要在 Security 配置中允许预检请求（OPTIONS）。

避免“只是CRUD”的质疑：
- 突出业务复杂性：在答辩中，重点讲解像“预约时间冲突校验”、“寄养费用动态计算（根据宠物大小、节假日）”、“健康记录趋势分析”这样的非标准 CRUD 逻辑。
- 展示设计模式：在代码中适当使用策略模式（如不同的支付方式计算）、观察者模式（如预约成功发送短信通知），并在文档和答辩中说明。
- 强调架构思想：说明你为何采用分层架构、模块化设计，这体现了你的工程能力，远超 CRUD。

5. 未来扩展：微服务架构的思考

这个单体架构的系统已经具备了良好的模块化基础。如何将其改造成微服务？

服务拆分：将user、pet、boarding、grooming、health等核心领域模块，各自独立为微服务。每个服务拥有自己的数据库（数据库拆分）。
服务通信：使用 Spring Cloud Alibaba 的 Nacos 作为注册中心和配置中心，使用 OpenFeign 进行声明式的服务间 HTTP 调用。对于预约状态同步等场景，可引入 RocketMQ 进行异步解耦。
统一网关：引入 Spring Cloud Gateway，作为所有前端请求的入口，统一处理鉴权（JWT校验）、限流、路由转发。
分布式事务：对于跨服务的业务（如用户下单预约同时扣减积分），考虑使用 Seata 的 AT 模式或基于消息的最终一致性方案。
可观测性：每个微服务集成 Spring Boot Admin 或 SkyWalking，监控服务健康、链路追踪和日志聚合。

这样一来，系统就从一个毕业设计级别的项目，演进成了一个具备高并发、高可用潜力的分布式系统原型。这不仅是技术上的升级，更是对软件架构深刻理解的体现。

做这个宠物综合服务系统毕设的过程，更像是一次规范的软件工程实践。从需求分析、技术选型、架构设计、编码实现到性能安全考量，每一步都踩过坑，也都有收获。希望这篇笔记里的思路和代码片段，能帮你避开一些常见的陷阱，做出一个让导师眼前一亮、也能为自己求职加分的优秀毕业设计。记住，好的毕设不在于功能有多炫酷，而在于它是否体现了你扎实的工程化思维和解决复杂问题的能力。

查看全文

http://www.jsqmd.com/news/403062/