1. 项目背景与意义随着城市化进程不断加快社区流浪猫狗数量持续增长由此带来的公共卫生、邻里矛盾与动物福利问题日益突出。传统救助模式主要依赖个人自发投喂和少数志愿者的线下行动普遍存在信息分散、资源错配、救助响应慢、缺乏协同机制等痛点。本课题设计并实现一个基于 Spring Boot 的社区流浪猫狗协同救助系统旨在搭建一个连接社区居民、志愿者、救助组织和宠物医院的线上协同平台。通过统一的信息发布、任务流转与资源对接系统能够有效提升流浪动物救助的响应效率与透明度推动社区治理与动物保护工作的数字化、常态化发展。2. 系统技术栈本系统采用前后端分离架构后端基于 Spring Boot 生态构建前端使用 Vue 框架数据库选用 MySQL整体技术选型如下层次技术选型说明后端框架Spring Boot 2.7快速构建 RESTful API简化配置与部署持久层框架MyBatis-Plus简化 CRUD 操作内置分页与条件构造器安全认证Spring Security JWT实现用户登录鉴权与接口访问控制数据库MySQL 8.0存储用户、救助任务、宠物档案等核心数据缓存中间件Redis缓存热点数据存储验证码与在线状态前端框架Vue 3 Element Plus构建管理后台与移动端适配页面文件存储阿里云 OSS存储宠物照片、救助现场图片等附件接口文档Swagger / Knife4j自动生成在线接口调试文档3. 系统功能模块设计系统面向社区居民、志愿者、管理员三类角色核心功能模块划分如下用户管理模块支持微信扫码登录、手机号注册、个人信息维护与志愿者认证申请。流浪动物档案模块为每只被发现的流浪猫狗建立电子档案记录发现位置、健康状况、绝育状态与领养状态。救助任务协同模块居民可发布求助信息系统自动匹配附近志愿者支持任务接单、进度反馈与完成确认。领养审核模块发布待领养宠物信息意向领养人提交申请管理员审核领养资质并跟踪回访记录。社区公告与科普模块发布社区救助动态、文明养宠宣传与动物福利科普文章。数据统计看板面向管理员展示救助完成率、领养转化率、区域分布等可视化统计图表。4. 数据库设计系统核心数据表包括用户表、宠物档案表、救助任务表、领养申请表、公告表等。以下为救助任务表的核心字段设计CREATE TABLE rescue_task ( id BIGINT PRIMARY KEY AUTO_INCREMENT COMMENT 任务ID, pet_id BIGINT COMMENT 关联宠物档案ID, reporter_id BIGINT COMMENT 发布人ID, volunteer_id BIGINT COMMENT 接单志愿者ID, task_type VARCHAR(20) COMMENT 任务类型FEED/TRAP/MEDICAL/ADOPT, status TINYINT COMMENT 状态0待接单 1进行中 2已完成 3已取消, location VARCHAR(255) COMMENT 发现位置, description TEXT COMMENT 任务描述, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP );5. 核心代码实现以下选取救助任务发布与接单流程中的关键代码进行说明。5.1 救助任务实体类Data TableName(rescue_task) public class RescueTask { TableId(type IdType.AUTO) private Long id; private Long petId; private Long reporterId; private Long volunteerId; private String taskType; private Integer status; private String location; private String description; TableField(fill FieldFill.INSERT) private LocalDateTime createTime; TableField(fill FieldFill.INSERT_UPDATE) private LocalDateTime updateTime; }5.2 救助任务服务层Service RequiredArgsConstructor public class RescueTaskServiceImpl implements RescueTaskService { private final RescueTaskMapper rescueTaskMapper; private final PetProfileMapper petProfileMapper; private final RedisTemplateString, String redisTemplate; Override Transactional(rollbackFor Exception.class) public Long publishTask(RescueTaskPublishDTO dto, Long reporterId) { // 1. 创建或更新宠物档案 PetProfile pet new PetProfile(); pet.setType(dto.getPetType()); pet.setLocation(dto.getLocation()); pet.setHealthStatus(UNKNOWN); petProfileMapper.insert(pet); // 2. 创建救助任务 RescueTask task new RescueTask(); task.setPetId(pet.getId()); task.setReporterId(reporterId); task.setTaskType(dto.getTaskType()); task.setStatus(0); task.setLocation(dto.getLocation()); task.setDescription(dto.getDescription()); rescueTaskMapper.insert(task); // 3. 通知附近志愿者简化写入待接单队列 redisTemplate.opsForList().leftPush(rescue:task:pending, String.valueOf(task.getId())); return task.getId(); } Override Transactional(rollbackFor Exception.class) public boolean acceptTask(Long taskId, Long volunteerId) { // 使用乐观锁防止多人同时接单 LambdaUpdateWrapperRescueTask wrapper new LambdaUpdateWrapper(); wrapper.eq(RescueTask::getId, taskId) .eq(RescueTask::getStatus, 0) .set(RescueTask::getVolunteerId, volunteerId) .set(RescueTask::getStatus, 1); return rescueTaskMapper.update(null, wrapper) 0; } }5.3 救助任务控制器RestController RequestMapping(/api/rescue) RequiredArgsConstructor public class RescueTaskController { private final RescueTaskService rescueTaskService; PostMapping(/task) public ResultLong publishTask(RequestBody Valid RescueTaskPublishDTO dto) { Long reporterId SecurityUtils.getCurrentUserId(); return Result.success(rescueTaskService.publishTask(dto, reporterId)); } PostMapping(/task/{taskId}/accept) public ResultBoolean acceptTask(PathVariable Long taskId) { Long volunteerId SecurityUtils.getCurrentUserId(); boolean success rescueTaskService.acceptTask(taskId, volunteerId); return success ? Result.success(true) : Result.error(任务已被接单或不存在); } GetMapping(/task/nearby) public ResultPageResultRescueTaskVO listNearbyTasks( RequestParam Double longitude, RequestParam Double latitude, RequestParam(defaultValue 1) Integer pageNum, RequestParam(defaultValue 10) Integer pageSize) { return Result.success(rescueTaskService.listNearbyTasks(longitude, latitude, pageNum, pageSize)); } }5.4 基于位置的附近任务查询Override public PageResultRescueTaskVO listNearbyTasks(Double longitude, Double latitude, Integer pageNum, Integer pageSize) { PageRescueTask page new Page(pageNum, pageSize); // 使用 Haversine 公式计算距离并按距离排序 QueryWrapperRescueTask wrapper new QueryWrapper(); wrapper.select(*, ROUND(6371 * 2 * ASIN(SQRT( POWER(SIN(({0} - ABS(latitude)) * PI() / 180 / 2), 2) COS({0} * PI() / 180) * COS(ABS(latitude) * PI() / 180) * POWER(SIN(({1} - longitude) * PI() / 180 / 2), 2))), 2) AS distance, latitude, longitude)) .eq(status, 0) .orderByAsc(distance); PageRescueTask result rescueTaskMapper.selectPage(page, wrapper); return PageResult.of(result); }6. 系统特色与创新点协同救助闭环从发现上报、任务派发、志愿者接单到完成反馈形成完整闭环避免信息孤岛。地理位置匹配基于经纬度计算任务距离优先推荐附近志愿者缩短救助响应时间。乐观锁防并发抢单通过数据库乐观锁机制保证同一任务只能被一名志愿者接单避免数据冲突。档案与任务联动每只流浪动物从被发现起即建立档案救助、医疗、领养全过程可追溯。7. 总结与展望本文设计并实现了一个基于 Spring Boot 的社区流浪猫狗协同救助系统覆盖用户管理、宠物档案、任务协同、领养审核与数据统计等核心功能。系统通过前后端分离架构与位置匹配算法有效提升了社区流浪动物救助的协同效率与信息透明度。后续可在以下方向继续优化引入地图可视化展示救助热力分布对接微信小程序降低居民使用门槛结合图像识别技术辅助流浪动物品种与健康状态初判完善志愿者信用评价体系进一步推动社区共治与动物保护的可持续发展。