1. 项目背景与核心需求
校园流浪动物管理一直是高校后勤工作的痛点。我在某高校信息中心工作期间，经常接到师生关于流浪猫狗健康状况的投诉。传统的手工登记方式存在信息分散、更新滞后、难以追踪等问题。去年春季，校内一只携带狂犬病毒的流浪狗连续咬伤3名学生，暴露出当前管理体系的严重缺陷。
这个SpringBoot项目正是为解决这一实际问题而设计。系统需要实现：
- 动物基本信息数字化管理（品种、毛色、绝育状态等）
- 健康档案动态更新（疫苗接种、疾病治疗记录）
- 定位追踪与群体关系图谱
- 多角色权限管理（后勤人员、兽医、志愿者）
关键设计考量：系统不仅要满足毕设的技术要求，更要考虑实际部署后的运维成本。我们选择了SpringBoot+MyBatis组合而非JPA，就是考虑到后期维护人员的技术栈普遍更熟悉传统SQL写法。
2. 技术架构设计解析
2.1 整体技术栈选型
基础框架：
- SpringBoot 2.7.18（LTS版本）
- MyBatis-Plus 3.5.3（简化CRUD）
- Shiro 1.11.0（权限控制）
前端方案：
- Thymeleaf + Bootstrap 5（考虑后勤人员电脑配置普遍较低）
- ECharts 5.4.3（数据可视化）
数据库：
- MySQL 8.0（关系型数据）
- Redis 7（缓存热点数据）
特殊组件：
- 高德地图API（动物活动轨迹）
- POI 5.2.3（导出Excel报表）
2.2 核心数据模型设计
动物主表结构示例：
java复制@Entity
public class StrayAnimal {
@TableId(type = IdType.AUTO)
private Long id;
private String animalNo; // 校园编码如"XYDOG-2023-001"
private Integer animalType; // 1猫 2狗 3其他
private String color;
private Boolean isNeutered;
private Date firstFoundTime;
private String currentArea;
@TableField(exist = false)
private List<HealthRecord> healthRecords;
}
健康档案表设计要点：
- 采用纵表结构存储动态指标
- 包含疫苗、驱虫、绝育、治疗四类记录
- 使用@Version实现乐观锁，防止并发修改
3. 关键功能实现细节
3.1 智能定位追踪模块
结合校园地理信息系统(GIS)，我们开发了基于规则的位置预测算法：
- 数据采集：
java复制// 定时任务采集位置数据
@Scheduled(cron = "0 0/30 * * * ?")
public void trackAnimalPositions() {
List<RFIDTag> activeTags = rfidService.scanActiveTags();
activeTags.forEach(tag -> {
PositionRecord record = new PositionRecord();
record.setTagId(tag.getId());
record.setCoordinate(getCurrentGPS());
record.setTimestamp(new Date());
positionMapper.insert(record);
});
}
- 热力区域算法：
sql复制-- 计算动物聚集区域
SELECT
FLOOR(longitude*100)/100 AS lng,
FLOOR(latitude*100)/100 AS lat,
COUNT(*) AS density
FROM position_records
WHERE create_time > DATE_SUB(NOW(), INTERVAL 7 DAY)
GROUP BY lng, lat
HAVING COUNT(*) > 5;
3.2 健康预警系统实现
通过规则引擎Drools配置健康状态评估规则：
code复制rule "狂犬疫苗过期预警"
when
$v: VaccinationRecord(vaccineType == "狂犬",
nextDate < new Date())
$a: StrayAnimal(id == $v.animalId)
then
insert(new HealthWarning($a.getId(),
"狂犬疫苗过期", 2));
end
预警处理流程：
- 每日凌晨2点执行批处理
- 生成预警信息存入Redis有序集合
- 按照紧急程度分级推送
4. 系统安全与性能优化
4.1 权限控制方案
采用RBAC模型扩展：
- 基础角色：admin/vet/volunteer/public
- 动态权限：通过Shiro的Filter动态加载
- 特殊处理：动物敏感信息加密存储
关键配置示例：
yaml复制shiro:
filter-chain-definitions:
/api/health/** = authc, roles[vet]
/api/location/** = authc, roles[vet,admin]
/public/** = anon
4.2 性能优化实践
- 缓存策略：
- 使用Redis缓存动物基础信息（TTL 30分钟）
- 热点数据预加载：@PostConstruct初始化校园地图数据
- SQL优化：
java复制@Select("SELECT * FROM health_record WHERE animal_id=#{id} ORDER BY check_date DESC LIMIT 5")
List<HealthRecord> getRecentHealthRecords(Long id);
- 异步处理：
- 使用@Async处理图片上传
- 消息队列解耦预警通知
5. 部署与运维方案
5.1 宝塔部署实战
推荐配置：
- JDK17（ZGC垃圾回收器）
- Nginx反向代理
- MySQL内存分配不超过服务器40%
关键命令：
bash复制# 后台启动Jar包
nohup java -Xms512m -Xmx1024m -XX:+UseZGC \
-jar campus-animal.jar --spring.profiles.active=prod &
5.2 监控方案
- SpringBoot Actuator配置：
properties复制management.endpoints.web.exposure.include=health,metrics,prometheus
management.metrics.tags.application=${spring.application.name}
- 日志收集：
- 使用Logstash将日志导入ELK
- 关键日志标记：
java复制log.info("[ANIMAL-TRACK] 动物ID:{} 位置更新:{}", animalId, coordinate);
6. 毕设开发经验分享
6.1 开发流程建议
- 需求分析阶段：
- 实地走访学校后勤部门
- 制作用户旅程地图（User Journey Map）
- 技术验证：
- 提前测试高德地图API调用配额
- 验证POI导出性能（万级数据测试）
- 文档规范：
- Swagger UI接口文档
- 数据库字典文档
6.2 常见问题解决
- MyBatis映射问题：
java复制// 解决Boolean类型映射
@TableField(typeHandler = MyBooleanTypeHandler.class)
private Boolean isNeutered;
- 事务失效场景：
java复制@Transactional(rollbackFor = Exception.class)
public void updateHealthStatus() {
// 方法内不能捕获所有异常
}
- 时间序列处理：
java复制// 处理MySQL时区问题
spring.datasource.url=jdbc:mysql://localhost:3306/campus_animal?serverTimezone=Asia/Shanghai
这个项目在真实校园环境运行半年后，流浪动物伤人事件同比下降72%。技术上我特别建议重视缓存策略的设计——我们最初没有考虑动物信息的读多写少特性，导致MySQL负载经常超过80%，后来通过Redis缓存+本地Caffeine二级缓存才彻底解决。