Java宠物管理系统：Spring Boot分层架构与事务实战

简介本资源是一套完整的Java Web课程设计项目——基于SSM框架的宠物管理系统面向计算机专业本科生、Java初学者及Web开发入门者旨在通过真实业务场景宠物信息管理、用户领养记录等帮助学习者掌握企业级Java全栈开发流程。资源包共1442个文件涵盖93个核心Java类、111个JSP页面、128个CSS与282个JS脚本支撑Layui前端交互、266个PNG及211个GIF素材界面图标与动效以及MySQL数据库文件.sql、.db和MyEclipse工程配置文件整体136.6MB结构完整、开箱即用。已有2173人学习下载资源包含可直接运行的编译后class文件、分层清晰的Action控制器如DingdanAction、UsersAction、XinxiAction等、DAO与Service模块以及配套SQL建表语句与系统部署说明便于快速理解MVC分层逻辑、调试SSM整合细节并复现完整业务流。1. 为什么一个“宠物管理系统”值得用 Java 重做一遍不是练手 Demo而是验证你对分层架构、事务边界和真实业务约束的掌控力很多人看到“基于Java的宠物管理系统”第一反应是这不就是大二课程设计填几个 Swing 表单、连个 H2 内存库、CRUD 跑通就交差。但现实里某高校实验室在承接本地宠物收容所数字化改造时发现真正卡住进度的从来不是“怎么增删改查”而是——当管理员同时给三只刚绝育的猫录入术后护理记录、同步更新疫苗状态、并触发领养意向通知时数据库里出现两条重复的驱虫时间戳或是导出“近30天活跃寄养订单”报表时因未隔离读写事务导出结果里混入了正在编辑但尚未保存的草稿数据。这些不是玄学是 Java EE 生态下对 JPA 一级缓存生命周期、Spring Transactional 传播行为、以及 DTO 与 Entity 边界模糊的真实反噬。本项目不是教你怎么拖控件而是带你用 Spring Boot 3.2 MyBatis-Plus 3.5 Thymeleaf 构建一个能经受住并发录入、状态流转、导出一致性校验的最小可行系统。适合两类人一是刚写完 SSM 项目但总被问“事务失效在哪”的开发者二是想把课堂代码升级为可部署到 Linux 服务器、带日志审计和基础权限的工程化实践者。我们不造轮子但会亲手拧紧每一颗螺丝。2. 从零搭起可运行骨架用 Spring Initializr 定义最小依赖集避开自动配置陷阱2.1 初始化项目选对 Starter 比写代码更重要打开 start.spring.io或使用 IDEA 内置向导勾选以下且仅以下依赖Spring WebSpring Data JDBC注意不是 JPA原因见 2.2LombokValidationThymeleafH2 Database开发阶段MyBatis Framework手动引入 MyBatis-Plus避免 Spring Boot 自动配置干扰提示不选 Spring Data JPA 是因本项目需显式控制 SQL 执行时机如批量导入宠物档案时绕过 Hibernate 一级缓存、且要支持复杂多表关联查询如“查所有已绝育且未接种狂犬疫苗的犬只”。JDBC Starter 提供 DataSource 和 TransactionManager 基础能力MyBatis-Plus 则负责 SQL 映射与分页——二者组合更贴近真实企业级 ORM 使用习惯。2.2 手动引入 MyBatis-Plus 并禁用自动配置在pom.xml中添加依赖版本必须与 Spring Boot 3.2 兼容dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-spring-boot3-starter/artifactId version3.5.5/version /dependency关键一步在application.yml中关闭 Spring Boot 对 MyBatis 的自动配置防止其与 MyBatis-Plus 冲突spring: autoconfigure: exclude: - org.mybatis.spring.boot.autoconfigure.MybatisAutoConfiguration2.3 创建核心实体与 Mapper 接口以Pet实体为例定义清晰的业务字段非数据库字段Data TableName(pet_info) public class Pet { TableId(type IdType.ASSIGN_ID) // 雪花ID避免MySQL自增主键在分布式场景问题 private Long id; private String name; // 宠物名 private Integer species; // 1猫, 2犬, 3兔用枚举常量非字符串 private Integer gender; // 0公, 1母 private LocalDate birthday; private String microchipId; // 芯片号唯一索引 private LocalDateTime createdAt; private LocalDateTime updatedAt; }对应 Mapper 接口继承BaseMapper不写 XML 文件MyBatis-Plus 提供默认 CRUDMapper public interface PetMapper extends BaseMapperPet { // 仅在此处写自定义SQL如复杂联查 Select(SELECT p.*, v.vaccine_name FROM pet_info p LEFT JOIN pet_vaccination pv ON p.id pv.pet_id LEFT JOIN vaccine_info v ON pv.vaccine_id v.id WHERE p.species #{species} AND v.is_rabies 1) ListMapString, Object selectUnvaccinatedRabies(Param(species) Integer species); }逻辑说明TableName显式绑定表名避免命名冲突TableId指定 ID 生成策略雪花ID 在单机开发环境也完全可用Select注解内写原生 SQL比 XML 更轻量且 IDE 支持语法高亮与参数提示。此处selectUnvaccinatedRabies方法返回MapString, Object而非实体类是因为查询结果含宠物基础信息疫苗名称属于典型“非聚合根”临时视图强行映射到实体会污染领域模型。3. 业务层设计用 Service 层封装状态流转规则让“绝育”“领养”“寄养”变成可测试的原子操作3.1 定义宠物生命周期状态机不采用硬编码状态值而用枚举明确业务语义public enum PetStatus { AVAILABLE(1, 可领养), // 新录入、健康检查通过 ADOPTED(2, 已领养), // 领养协议签署完成 BOARDING(3, 寄养中), // 已入住寄养中心 SURGERY_PENDING(4, 术前待安排), // 绝育/结扎预约中 SURGERY_DONE(5, 术后恢复中), // 手术完成需每日护理 VACCINATION_DUE(6, 疫苗到期); // 狂犬/猫三联等需补种 private final int code; private final String desc; PetStatus(int code, String desc) { this.code code; this.desc desc; } // getter 省略 }3.2 编写状态变更 Service 方法以“执行绝育手术”为例Service Transactional(rollbackFor Exception.class) public class PetService { Autowired private PetMapper petMapper; Autowired private PetMedicalRecordMapper medicalRecordMapper; // 医疗记录Mapper /** * 执行绝育手术原子性更新宠物状态 记录医疗事件 * param petId 宠物ID * param surgeryDate 手术日期 * param surgeonName 主刀医生 */ public void performSpayNeuter(Long petId, LocalDate surgeryDate, String surgeonName) { // 1. 校验宠物当前状态是否允许手术业务规则 Pet pet petMapper.selectById(petId); if (pet null) { throw new IllegalArgumentException(宠物不存在); } if (!PetStatus.AVAILABLE.equals(pet.getStatus()) !PetStatus.SURGERY_PENDING.equals(pet.getStatus())) { throw new IllegalStateException(仅可对【可领养】或【术前待安排】状态的宠物执行手术); } // 2. 更新宠物状态为术后恢复中 pet.setStatus(PetStatus.SURGERY_DONE.getCode()); pet.setUpdatedAt(LocalDateTime.now()); petMapper.updateById(pet); // 3. 记录医疗事件独立事务不同一事务内保证强一致性 PetMedicalRecord record new PetMedicalRecord(); record.setPetId(petId); record.setEventType(SPAY_NEUTER); record.setEventDate(surgeryDate); record.setDetails(主刀 surgeonName 术后护理周期14天); record.setCreatedAt(LocalDateTime.now()); medicalRecordMapper.insert(record); } }参数说明Transactional(rollbackFor Exception.class)确保数据库更新与医疗记录插入在同一事务中回滚PetStatus.SURGERY_DONE.getCode()将枚举转为整型存库避免字符串存储导致索引失效medicalRecordMapper.insert(record)不用save()而用insert()因save()会先查后插此处明确是新增记录。3.3 Controller 层接收请求并转换参数RestController RequestMapping(/api/pets) public class PetController { Autowired private PetService petService; PostMapping(/{id}/surgery) public ResponseEntityString executeSurgery( PathVariable Long id, RequestBody Valid SurgeryRequest request) { // 自定义DTO含校验注解 try { petService.performSpayNeuter(id, request.getSurgeryDate(), request.getSurgeonName()); return ResponseEntity.ok(手术记录已更新); } catch (IllegalArgumentException | IllegalStateException e) { return ResponseEntity.badRequest().body(e.getMessage()); } } } // DTO 与 Entity 分离避免暴露数据库字段 Data public class SurgeryRequest { NotNull private LocalDate surgeryDate; NotBlank private String surgeonName; }逻辑说明Valid触发SurgeryRequest的NotNull和NotBlank校验失败时由 Spring 全局异常处理器捕获无需在 Service 内重复判断ResponseEntity显式返回 HTTP 状态码比ResponseBody更符合 RESTful 规范SurgeryRequest作为纯传输对象不包含任何数据库字段如id、createdAt彻底隔离表现层与持久层。4. 避坑指南那些让新手调试到凌晨三点的“合理”错误4.1 现象分页查询返回空列表但数据库明明有数据原因MyBatis-Plus 的Page对象未正确设置current当前页和size每页条数或IPage接口未被PageHandler正确拦截。常见误用// ❌ 错误未设置 current 和 sizePage 默认值为 0导致 SQL LIMIT 0,0 PagePet page new Page(); petMapper.selectPage(page, null);解决显式初始化分页参数并确保selectPage方法被 MyBatis-Plus 的分页插件拦截// ✅ 正确current 从 1 开始size 设为 10 PagePet page new Page(1, 10); // 第1页每页10条 IPagePet result petMapper.selectPage(page, null); // 同时在配置类中启用分页插件必须 Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.H2)); // 开发用H2 return interceptor; }4.2 现象修改宠物名字后前端显示仍是旧值原因Thymeleaf 模板中未使用th:field绑定表单字段或 Controller 返回 Model 时未重新查询最新数据。解决表单必须用th:field*{name}星号表示当前对象而非th:value${pet.name}更新操作后重定向到详情页return redirect:/pets/ id而非直接返回模板避免浏览器缓存旧 Model若需在更新后立即展示Controller 中必须petMapper.selectById(id)查询最新数据再放入 Model。4.3 现象批量导入 1000 条宠物数据耗时 8 分钟且内存溢出原因循环调用petMapper.insert(pet)每次 insert 都触发一次数据库连接获取、SQL 解析、事务开启/提交。解决改用 MyBatis-Plus 的saveBatch方法并配置 JDBC URL 参数// ✅ 正确开启批处理减少网络往返 ListPet pets parseExcel(file); // 解析Excel得到List boolean success petService.saveBatch(pets, 100); // 每100条一批 // application.yml 中添加 spring: datasource: url: jdbc:h2:mem:testdb;DB_CLOSE_DELAY-1;DB_CLOSE_ON_EXITFALSE;BATCH_SIZE100saveBatch底层调用PreparedStatement.addBatch()配合 JDBC 的BATCH_SIZE参数将 100 条 INSERT 合并为单次网络包发送。4.4 现象Transactional失效数据库更新成功但抛出异常后未回滚原因最常见于 Service 类内部方法调用A 方法调用 B 方法B 加了Transactional但 A 未加导致事务上下文未传播。解决确保事务方法被 Spring 代理对象调用即从 Controller 或其他 Service 调用而非本类内部调用若必须内部调用用ApplicationContext获取代理对象Service public class PetService { Autowired private ApplicationContext context; public void doSomething() { // 通过代理对象调用确保事务生效 PetService proxy context.getBean(PetService.class); proxy.updateWithTransaction(); } Transactional public void updateWithTransaction() { // 数据库操作 } }5. 导出报表与权限控制用 POI 实现无模板 Excel 导出用 Session Filter 实现轻量级权限拦截5.1 用 Apache POI 动态生成 Excel 报表不依赖 Excel 模板文件需求导出“本月寄养订单汇总”含订单号、宠物名、主人姓名、寄养天数、费用。GetMapping(/export/boardings) public void exportBoardingReport(HttpServletResponse response) throws IOException { ListBoardingReportVO reports boardingService.getMonthlyReport(); // VO 专为导出设计 // 创建工作簿和工作表 XSSFWorkbook workbook new XSSFWorkbook(); XSSFSheet sheet workbook.createSheet(寄养汇总); // 写入表头动态列名 String[] headers {订单号, 宠物名, 主人姓名, 寄养天数, 费用(元)}; XSSFRow headerRow sheet.createRow(0); for (int i 0; i headers.length; i) { headerRow.createCell(i).setCellValue(headers[i]); } // 写入数据行 int rowNum 1; for (BoardingReportVO report : reports) { XSSFRow row sheet.createRow(rowNum); row.createCell(0).setCellValue(report.getOrderNo()); row.createCell(1).setCellValue(report.getPetName()); row.createCell(2).setCellValue(report.getOwnerName()); row.createCell(3).setCellValue(report.getDays()); row.createCell(4).setCellValue(report.getAmount()); } // 设置响应头触发下载 response.setContentType(application/vnd.openxmlformats-officedocument.spreadsheetml.sheet); response.setHeader(Content-Disposition, attachment; filenameboarding_report_ LocalDate.now() .xlsx); workbook.write(response.getOutputStream()); workbook.close(); }逻辑说明XSSFWorkbook用于.xlsx格式兼容性优于 HSSFcreateCell()直接写入值避免setCellValue(String)的类型推断错误response.setHeader中filename包含日期防止浏览器缓存旧文件workbook.close()必须调用否则流未关闭导致内存泄漏。5.2 用 Session Filter 实现角色权限控制不引入 Spring Security定义简单角色ADMIN可操作全部、STAFF仅查看与录入、VOLUNTEER仅查看。// 登录成功后存入 Session PostMapping(/login) public String login(RequestParam String username, RequestParam String password, HttpSession session) { User user userService.authenticate(username, password); if (user ! null) { session.setAttribute(currentUser, user); // 存用户对象 session.setAttribute(role, user.getRole()); // 存角色字符串 return redirect:/dashboard; } return login?error; }编写PermissionFilter拦截敏感路径Component Order(Ordered.HIGHEST_PRECEDENCE) public class PermissionFilter implements Filter { Override public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException { HttpServletRequest httpRequest (HttpServletRequest) request; HttpServletResponse httpResponse (HttpServletResponse) response; String path httpRequest.getRequestURI(); String role (String) httpRequest.getSession().getAttribute(role); // 定义权限规则只有 ADMIN 可访问 /api/pets/delete if (path.startsWith(/api/pets/delete) !ADMIN.equals(role)) { httpResponse.sendError(HttpServletResponse.SC_FORBIDDEN, 无权删除宠物信息); return; } // STAFF 和 ADMIN 可访问 /api/pets/createVOLUNTEER 不行 if (path.startsWith(/api/pets/create) !STAFF.equals(role) !ADMIN.equals(role)) { httpResponse.sendError(HttpServletResponse.SC_FORBIDDEN, 无权创建宠物); return; } chain.doFilter(request, response); } }注意此方案适用于小规模系统。若需 RBAC基于角色的访问控制或细粒度权限如“仅能编辑自己录入的宠物”应升级为 Spring Security JWT但本项目目标是“最小可行权限”避免过度设计。6. 验证系统健壮性的三个实操技巧用 Postman 模拟并发、用 H2 CONSOLE 查看实时数据、用 Actuator 检查运行时状态6.1 用 Postman Runner 模拟 50 个并发请求测试状态更新场景验证“执行绝育手术”接口在高并发下是否出现状态覆盖。在 Postman 中创建POST /api/pets/{{petId}}/surgery请求Body 选择raw → JSON填入{surgeryDate: 2024-06-15, surgeonName: 张医生}点击Runner设置 Collection 为当前请求Iterations 设为50Delay 设为0模拟瞬时并发运行后观察成功数应为 50HTTP 200数据库中该宠物的status字段应为5SURGERY_DONE且updated_at时间戳应全部相同因事务串行化若出现部分请求返回 500则检查PetService中performSpayNeuter方法是否缺少Transactional或存在未捕获异常。6.2 用 H2 Console 实时验证数据一致性启动应用后访问http://localhost:8080/h2-console需在application.yml中开启spring: h2: console: enabled: true path: /h2-consoleJDBC URL 填jdbc:h2:mem:testdb执行 SQL-- 查看宠物表与医疗记录表关联是否正确 SELECT p.name, p.status, m.event_type, m.event_date FROM pet_info p JOIN pet_medical_record m ON p.id m.pet_id WHERE p.id 123;若结果中p.status 5但m.event_type为空说明performSpayNeuter方法中medicalRecordMapper.insert()未执行成功需检查medicalRecordMapper是否被Mapper正确扫描。6.3 用 Spring Boot Actuator 检查运行时健康状态添加 Actuator 依赖dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-actuator/artifactId /dependency配置暴露端点management: endpoints: web: exposure: include: health, metrics, threaddump, loggers endpoint: health: show-details: always访问http://localhost:8080/actuator/health确认status: UP且diskSpace、db子项均为UP访问http://localhost:8080/actuator/metrics/jvm.memory.used监控内存使用若导出报表后内存未回落说明 POIworkbook.close()未执行访问http://localhost:8080/actuator/threaddump当系统卡顿时下载线程快照搜索WAITING状态线程定位数据库连接池耗尽或死锁。我带过的某开发者曾因忽略workbook.close()在生产环境导出报表后内存持续增长最终 OOM。后来他养成习惯所有资源型对象Workbook、InputStream、Connection的创建与关闭必须成对出现在同一方法内用try-with-resources或明确close()调用。这种肌肉记忆比记住一百个框架注解都管用。希望帮到你。本文还有配套的精品资源点击获取