SpringBoot与Uni-app构建高校宿舍管理系统实践

马迪姐

1. 项目背景与核心价值

高校宿舍管理一直是校园后勤工作的重点难点。传统纸质登记、Excel表格统计的方式效率低下，信息更新滞后，查寝结果难以及时同步，学生报修流程繁琐。基于SpringBoot和小程序的高校宿舍管理系统，正是为解决这些痛点而生。

这个系统将宿舍分配、卫生检查、设备报修、访客登记等高频场景全部线上化。学生通过微信小程序即可完成各类申请和查询，宿管人员通过后台管理系统实时处理业务。我去年在某职业技术学院落地过类似项目，上线后宿舍相关事务处理效率提升60%以上，学生满意度调查显示报修响应速度从原来的平均3天缩短到8小时内。

2. 技术架构设计

2.1 整体技术栈选型

采用SpringBoot + Uni-app前后端分离架构。后端选用SpringBoot 2.7.x版本，主要考虑其：

自动配置特性快速搭建项目
丰富的starter依赖简化整合
内嵌Tomcat便于部署
完善的监控机制（Actuator）

数据库使用MySQL 8.0，主要优势：

高校场景下数据量通常在百万级，MySQL完全胜任
事务支持完善，适合宿舍分配等需要强一致性的场景
高校IT部门普遍熟悉MySQL运维

小程序端选择Uni-app而非原生开发，因为：

一套代码可同时发布到微信、支付宝等多端
开发效率比原生开发高30%以上
组件库丰富，适合快速迭代

2.2 核心模块划分

系统主要包含6个核心模块：

身份认证模块：采用JWT+RBAC模型，区分学生、宿管、后勤三种角色权限
宿舍管理模块：处理床位分配、调换、退宿等业务流程
报修管理模块：实现报修-派单-维修-评价闭环
访客管理模块：线上预约与入离校登记
卫生检查模块：检查项配置与评分统计
消息通知模块：整合微信模板消息实现实时提醒

3. 关键实现细节

3.1 微信小程序登录流程设计

采用unionId作为用户唯一标识是关键。具体实现流程：

java复制// 后端登录接口核心代码
@PostMapping("/wxLogin")
public Result wxLogin(@RequestBody LoginDTO dto) {
    // 1. 调用微信接口获取session_key
    String url = "https://api.weixin.qq.com/sns/jscode2session?appid=" 
        + appId + "&secret=" + appSecret + "&js_code=" + dto.getCode() + "&grant_type=authorization_code";
    WxAuthResponse response = restTemplate.getForObject(url, WxAuthResponse.class);
    
    // 2. 解密获取用户信息
    String decryptData = decrypt(dto.getEncryptedData(), response.getSession_key(), dto.getIv());
    WxUserInfo userInfo = JSON.parseObject(decryptData, WxUserInfo.class);
    
    // 3. 绑定或创建用户
    User user = userService.getByUnionId(userInfo.getUnionId());
    if(user == null) {
        user = new User();
        BeanUtils.copyProperties(userInfo, user);
        userService.save(user);
    }
    
    // 4. 生成JWT令牌
    String token = JwtUtil.generateToken(user.getId(), user.getRole());
    return Result.success(token);
}

特别注意：小程序获取手机号需要企业认证，很多高校项目卡在这个环节。建议前期先用微信昵称+学号验证的方式过渡。

3.2 宿舍分配算法实现

核心是解决新生批量分配时的多约束条件问题。我们设计的算法考虑：

院系专业集中原则
班级相对集中原则
特殊需求优先原则（如身体残疾）
床位余量均衡原则

具体实现采用权重评分法：

java复制public List<Student> autoAssign(List<Student> students) {
    // 1. 预处理：按专业班级分组
    Map<String, List<Student>> groupMap = students.stream()
        .collect(Collectors.groupingBy(s -> s.getMajor() + "_" + s.getClassNo()));
    
    // 2. 为每个宿舍计算适配度
    List<Dorm> dorms = dormService.getAvailableDorms();
    for (Dorm dorm : dorms) {
        for (String key : groupMap.keySet()) {
            List<Student> group = groupMap.get(key);
            // 计算该宿舍当前专业分布情况
            long sameMajorCount = dorm.getStudents().stream()
                .filter(s -> s.getMajor().equals(group.get(0).getMajor()))
                .count();
            
            // 计算权重得分
            double score = sameMajorCount * 0.6 
                + (4 - dorm.getStudents().size()) * 0.3
                + (dorm.getBuilding().equals(group.get(0).getPreferBuilding()) ? 0.1 : 0);
            
            dorm.setScore(score);
        }
    }
    
    // 3. 分配实现（简化版）
    return assignByScore(students, dorms);
}

3.3 报修工单状态机设计

工单状态流转是报修模块的核心，我们采用状态模式实现：

java复制public interface RepairState {
    void handle(RepairOrder order);
}

@Component
@Scope("prototype")
public class PendingState implements RepairState {
    @Override
    public void handle(RepairOrder order) {
        if ("ASSIGN".equals(order.getAction())) {
            order.setState(new AssignedState());
            // 发送微信通知维修人员
            wxNoticeService.sendRepairAssignNotice(order);
        }
    }
}

// 其他状态：AssignedState/ProcessingState/CompletedState等

// 使用示例
public void changeState(Long orderId, String action) {
    RepairOrder order = repairOrderMapper.selectById(orderId);
    RepairState state = (RepairState) applicationContext
        .getBean(order.getStatus().toLowerCase() + "State");
    state.handle(order);
    repairOrderMapper.updateById(order);
}

4. 性能优化实践

4.1 小程序端图片上传优化

宿舍报修场景中，学生上传损坏设备照片是高频操作。我们做了以下优化：

前端压缩：使用uni.compressImage API将图片压缩到800*600分辨率
分片上传：大文件采用分片上传，支持断点续传
CDN加速：使用腾讯云COS存储，配置CDN分发
缩略图生成：后端使用Thumbnailator生成200*200缩略图

关键配置示例：

properties复制# application.properties
cos.secretId=您的SecretId
cos.secretKey=您的SecretKey
cos.region=ap-shanghai
cos.bucketName=your-bucket-name
cos.thumb.width=200
cos.thumb.height=200

4.2 查寝数据批量导入

卫生检查场景需要批量导入Excel数据，采用EasyExcel解决内存问题：

java复制@PostMapping("/import")
public void importExcel(@RequestParam("file") MultipartFile file) {
    EasyExcel.read(file.getInputStream(), CheckRecord.class, new PageReadListener<CheckRecord>(dataList -> {
        // 批量处理每100条数据
        checkService.batchSave(dataList);
    })).sheet().doRead();
}

// 批量插入使用MyBatis的foreach标签
<insert id="batchInsert" parameterType="java.util.List">
    INSERT INTO check_record(dorm_id, inspector, score) 
    VALUES
    <foreach collection="list" item="item" separator=",">
        (#{item.dormId}, #{item.inspector}, #{item.score})
    </foreach>
</insert>

5. 典型问题排查

5.1 微信支付回调失败

报修完成后支付押金是常见场景，回调处理要点：

验签必须严格：使用微信支付提供的SDK验证签名
幂等处理：通过out_trade_no去重
网络超时：配置合理的超时时间（建议3秒）

回调接口示例：

java复制@PostMapping("/pay/callback")
public String callback(HttpServletRequest request) {
    // 1. 获取通知数据
    String xmlData = IOUtils.toString(request.getInputStream(), StandardCharsets.UTF_8);
    
    // 2. 验证签名
    if (!WxPayUtil.isSignatureValid(xmlData, apiKey)) {
        return "<xml><return_code><![CDATA[FAIL]]></return_code></xml>";
    }
    
    // 3. 处理业务
    WxPayOrderNotifyResult result = WxPayOrderNotifyResult.deserialize(xmlData);
    if ("SUCCESS".equals(result.getResultCode())) {
        repairOrderService.handlePaySuccess(result.getOutTradeNo());
    }
    
    return "<xml><return_code><![CDATA[SUCCESS]]></return_code></xml>";
}

5.2 高并发下的床位分配冲突

新生入学时集中分配宿舍容易产生并发问题，解决方案：

乐观锁控制：

sql复制UPDATE dorm SET remain_beds = remain_beds - 1 
WHERE id = #{dormId} AND remain_beds > 0

引入Redis分布式锁：

java复制public boolean assignBed(Long dormId, Long studentId) {
    String lockKey = "dorm:assign:" + dormId;
    try {
        // 尝试获取锁，设置10秒过期
        Boolean locked = redisTemplate.opsForValue()
            .setIfAbsent(lockKey, "1", 10, TimeUnit.SECONDS);
        if (locked != null && locked) {
            return dormService.doAssign(dormId, studentId);
        }
        return false;
    } finally {
        redisTemplate.delete(lockKey);
    }
}

6. 部署与运维建议

6.1 服务器配置方案

根据高校规模推荐配置：

5000人以下院校：
- 2核4G云服务器（后端）
- 1核2G（MySQL）
- 1Mbps带宽
5000-10000人院校：
- 4核8G（后端+Redis）
- 2核4G（MySQL）
- 2Mbps带宽
10000人以上院校：
- 考虑集群部署，Nginx负载均衡
- MySQL主从复制
- 对象存储分离

6.2 监控指标设置

必须监控的关键指标：

小程序端：
- 页面加载时间（应<1s）
- 接口成功率（应>99.5%）
- 崩溃率（应<0.1%）
服务端：
- JVM内存（Max < 80%）
- 数据库连接数（活跃<总连接数80%）
- 慢查询数量（应<5次/分钟）

配置Prometheus监控示例：

yaml复制# prometheus.yml
scrape_configs:
  - job_name: 'springboot'
    metrics_path: '/actuator/prometheus'
    static_configs:
      - targets: ['localhost:8080']