1. 项目背景与核心需求山西大同大学学生公寓管理系统是一个典型的校园信息化建设项目旨在解决传统纸质化宿舍管理中的效率低下、数据孤岛等问题。我在实际开发中发现高校宿舍管理通常面临三大痛点人工分配宿舍耗时耗力每年新生入学时管理员需要处理上千份住宿申请水电费收缴依赖线下登记经常出现漏记错记的情况访客管理缺乏数字化记录安全隐患难以追溯这个系统采用前后端分离架构前端使用Vue 3组合式API开发后端基于Spring Boot 2.7.x构建数据持久层选用MyBatis-Plus 3.5.x。这种技术栈组合在2023年高校信息化项目中已成为主流选择主要优势在于Vue的响应式特性非常适合处理频繁变动的宿舍调换数据Spring Boot的自动配置简化了复杂的权限管理体系开发MyBatis-Plus的Lambda查询大大减少了基础CRUD代码量2. 系统架构设计详解2.1 技术选型决策过程在技术验证阶段我们对比了多种方案前端框架选型Vue vs React最终选择Vue是因为其更平缓的学习曲线方便学校后续自主维护UI库对比Element Plus vs Ant Design Vue选择Element Plus因其表单组件更符合管理系统需求后端技术决策放弃JPA选择MyBatis-Plus因为需要复杂SQL处理宿舍分配算法使用Hutool工具包处理Excel导入导出比Apache POI更简洁数据库设计MySQL 8.0版本利用其窗口函数优化统计报表查询专门为宿舍楼栋表添加空间索引支持按地理位置查询2.2 核心功能模块实现2.2.1 智能宿舍分配算法// 基于专业、班级的分配策略实现 public class DormAllocator { public ListStudent autoAllocate(ListStudent students) { return students.stream() .collect(Collectors.groupingBy(s - s.getMajor() _ s.getClassId())) .values().stream() .flatMap(group - { // 每个专业班级按性别分组 MapBoolean, ListStudent byGender group.stream() .collect(Collectors.partitioningBy(Student::isMale)); return Stream.concat( allocateByGender(byGender.get(true)), allocateByGender(byGender.get(false)) ); }).collect(Collectors.toList()); } }关键点算法需要处理边缘情况如同性别人数不足填满整个宿舍时采用填空新开的混合策略2.2.2 水电费计算模块-- 按月统计宿舍水电费的视图 CREATE VIEW dorm_utility_view AS SELECT d.dorm_id, SUM(CASE WHEN u.type water THEN u.amount ELSE 0 END) AS water_usage, SUM(CASE WHEN u.type electric THEN u.amount ELSE 0 END) AS electric_usage, (water_rate * SUM(CASE WHEN u.type water THEN u.amount ELSE 0 END) electric_rate * SUM(CASE WHEN u.type electric THEN u.amount ELSE 0 END)) AS total_fee FROM dorm d JOIN utility_record u ON d.dorm_id u.dorm_id GROUP BY d.dorm_id;3. 开发中的典型问题与解决方案3.1 并发分配冲突处理当多个管理员同时操作宿舍分配时出现了床位重复分配的问题。我们最终采用两种方案结合数据库层面在bed表添加version字段实现乐观锁应用层面使用Redisson分布式锁控制分配入口Transactional public AllocationResult allocateBed(Long studentId, Long dormId) { RLock lock redissonClient.getLock(alloc: dormId); try { lock.lock(10, TimeUnit.SECONDS); // 检查床位状态 Bed targetBed bedMapper.selectOne(new LambdaQueryWrapperBed() .eq(Bed::getDormId, dormId) .eq(Bed::getStatus, 0) .last(FOR UPDATE)); if(targetBed ! null) { // 更新状态 targetBed.setStatus(1); targetBed.setStudentId(studentId); bedMapper.updateById(targetBed); return AllocationResult.success(targetBed.getBedNo()); } return AllocationResult.fail(无可用床位); } finally { lock.unlock(); } }3.2 大数据量导出优化在生成整栋楼的住宿名单Excel时最初方案导致OOM。改进方案使用Apache POI的SXSSFWorkbook实现流式导出添加分页查询每次处理500条记录前端采用WebSocket推送导出进度public void exportDormStudents(Long buildingId, HttpServletResponse response) { SXSSFWorkbook workbook new SXSSFWorkbook(100); // 保留100行在内存中 // 分页查询 int pageSize 500; int pageNo 1; while(true) { PageStudent page studentService.page(new Page(pageNo, pageSize), new LambdaQueryWrapperStudent() .eq(Student::getBuildingId, buildingId)); if(page.getRecords().isEmpty()) break; // 写入当前页数据 writePageData(workbook, page.getRecords()); pageNo; } // 写入响应流 workbook.write(response.getOutputStream()); workbook.dispose(); }4. 系统安全与权限设计4.1 基于RBAC的权限模型系统设计了五级角色超级管理员校方IT公寓管理员楼栋管理员辅导员学生使用Spring Security结合JWT实现鉴权关键配置Configuration EnableWebSecurity public class SecurityConfig { Bean SecurityFilterChain filterChain(HttpSecurity http) throws Exception { http.authorizeRequests() .antMatchers(/api/admin/**).hasRole(ADMIN) .antMatchers(/api/building/**).access(rbacService.checkBuildingAccess(authentication,#request)) .anyRequest().authenticated() .and() .addFilter(new JwtAuthenticationFilter(authenticationManager())) .sessionManagement().sessionCreationPolicy(SessionCreationPolicy.STATELESS); return http.build(); } }4.2 敏感数据保护措施学生身份证号等字段使用AES加密存储日志系统自动脱敏敏感信息数据库审计日志记录所有数据变更5. 部署与性能优化5.1 生产环境配置服务器配置前端Nginx容器2C4G后端Spring Boot应用4C8G×2实例数据库MySQL主从架构8C16G关键JVM参数-XX:UseG1GC -XX:MaxGCPauseMillis200 -XX:InitiatingHeapOccupancyPercent45 -Xms4g -Xmx4g5.2 缓存策略设计使用多级缓存提升查询性能本地缓存Caffeine缓存静态数据如楼栋信息Redis缓存热点数据宿舍剩余床位数分布式锁宿舍分配过程MySQL查询缓存配置表等低频修改数据Cacheable(value dorm, key #dormId) public DormInfo getDormInfo(Long dormId) { return dormMapper.selectByIdWithDetails(dormId); } CacheEvict(value dorm, key #dormId) public void updateDorm(Dorm dorm) { dormMapper.updateById(dorm); }6. 项目总结与扩展思考在实际开发过程中有几个经验值得特别分享数据一致性保障宿舍调换涉及多个表更新我们最终采用TCC模式实现分布式事务补偿机制设计是关键移动端适配后期新增微信小程序入口发现需要重构部分API以适应移动端场景建议初期就考虑多端兼容监控系统集成接入Prometheus监控后发现宿舍查询接口的99线偶尔飙高最终通过添加复合索引解决系统未来可扩展方向物联网集成对接智能电表实现自动抄表人脸识别结合门禁系统实现刷脸进出数据分析建立学生行为分析模型辅助管理决策