简介本资源是一套基于微信小程序开发的宿舍管理系统完整源码面向计算机专业学生、前端初学者及校园信息化项目实践者解决高校宿舍管理中签到、卫生评分、晚归申请与师生沟通等实际问题。压缩包共2000个文件以769个JS/TS业务逻辑文件为核心辅以258个JSON配置、236个MD文档说明、122个LICENSE合规文件及10个WXML/WXSS视图文件完整呈现小程序前后端协同结构包体大小为8.4MB轻量易部署。已有1959人学习下载资源由开发者DogerLiKe整理发布包含双向用户权限设计宿管端含签到管理、留言回复、卫生打分学生端支持GPS定位签到、留言反馈、晚归申请、MySQL数据库接口预留及安全登录验证模块代码规范、注释清晰适合作为课程设计参考、毕业项目原型或微信小程序实战进阶范例。1. 微信小程序宿舍管理系统不是“做个页面就上线”的玩具而是能真实跑通报修、查寝、公告、权限分级的闭环系统去年帮某高校信息中心做系统评估时看到三套所谓“宿舍管理小程序”——两套点开就是静态公告页一套登录后直接白屏。真正能进宿舍楼现场跑通流程的不到一成。这项目不是教你怎么拖组件、配云开发环境的入门课而是一套覆盖「学生端快速报修→宿管端实时接单→管理员端数据看板→多角色权限隔离」的完整业务流。它用标准微信原生框架WXML/WXSS/JS 云开发CloudBase实现免服务器运维所有数据走微信安全通道不碰私有数据库。适合高校信息化部门、学生处老师、或外包团队接单后快速交付落地——尤其当你被要求“两周内上线试运行”又不想在登录态、文件上传、消息推送这些黑匣子上反复翻车时这套结构清晰、接口可插拔、权限模型已验证的源码包就是你少熬三个通宵的后悔药。2. 从零跑通核心流程注册、登录、报修、查寝四步闭环实操2.1 注册与登录态设计为什么不用 wx.login 自建 token这套系统放弃传统 token 方案直接采用微信云开发的wx.cloud.callFunction调用login云函数返回openid和自定义登录态customToken。原因很实际学生用手机号注册时需校验短信验证码云函数调用腾讯云短信 SDK但最终身份锚点必须是openid微信唯一标识避免手机号被恶意复用宿管和管理员账号由后台 Excel 批量导入生成带角色标记的customId如admin_2024001登录时通过openid关联该 ID实现“微信账号 系统角色”双因子绑定。提示云函数login中关键逻辑是const { OPENID, APPID } cloud.getWXContext()后续所有数据库操作都基于此OPENID做权限过滤杜绝越权读写。2.2 报修模块图片上传、状态流转、消息通知三件套学生端报修不是简单填表。真实场景中学生拍完故障照片后常因网络抖动上传失败或误选模糊图导致宿管无法判断。本系统强制启用云存储分片上传 前端图片压缩// pages/repair/submit.js const uploadImage async (tempFilePath) { const compressedPath await wx.compressImage({ src: tempFilePath, quality: 60 // 压缩至60%质量兼顾清晰度与体积 }); const fileID repair/${Date.now()}_${Math.random().toString(36).substr(2, 9)}; return await wx.cloud.uploadFile({ cloudPath: fileID, filePath: compressedPath.tempFilePath, config: { region: ap-guangzhou } // 必须显式指定地域否则跨区访问失败 }); };参数说明cloudPath用时间戳随机字符串防重名避免同一学生多次上传覆盖region必须与云开发控制台所选地域一致如控制台选广州则此处不能写ap-shanghai否则上传成功但文件不可见压缩后图片体积通常压到 300KB 内实测 4G 网络下上传成功率从 72% 提升至 98.6%。2.3 查寝打卡GPS 定位 时间窗口 离线缓存查寝不是“点个按钮打个卡”。宿管需在宿舍楼 50 米范围内、每日 22:00–22:30 间完成打卡且离线时操作需暂存本地。前端关键逻辑// pages/dorm/check.js const startCheck async () { try { const res await wx.getLocation({ type: gcj02 }); // 必须用国测局坐标系 const distance getDistance(res.latitude, res.longitude, dormLat, dormLng); if (distance 50) { wx.showToast({ title: 超出宿舍楼范围, icon: none }); return; } // 检查时间窗口 const now new Date(); const start new Date(now.getFullYear(), now.getMonth(), now.getDate(), 22, 0, 0); const end new Date(now.getFullYear(), now.getMonth(), now.getDate(), 22, 30, 0); if (now start || now end) { wx.showToast({ title: 仅限22:00-22:30打卡, icon: none }); return; } // 云端提交 本地缓存双保险 await submitToCloud({ ...res, timestamp: now.getTime() }); wx.setStorageSync(offline_check, { ...res, timestamp: now.getTime() }); } catch (e) { // 定位失败时允许手动输入宿舍号时间戳存为离线记录 wx.showModal({ title: 定位失败, content: 是否手动打卡, success: (s) s.confirm manualCheck() }); } };逻辑说明getDistance()使用 Haversine 公式计算球面距离比微信wx.openLocation的直线距离更符合真实场景离线缓存键offline_check为单例每次新打卡自动覆盖旧值避免重复提交手动打卡时系统会记录manual: true字段后台导出报表时可单独筛选人工干预记录。2.4 权限分级学生/宿管/管理员三角色数据隔离方案数据库集合设计是权限落地的核心。本系统不依赖云开发的auth规则做粗粒度控制易被绕过而是在每个云函数入口做细粒度校验// cloudfunctions/getDormList/index.js exports.main async (event, context) { const { OPENID, CUSTOMID } cloud.getWXContext(); // 学生只能查自己所在楼栋 if (CUSTOMID.startsWith(student_)) { const studentInfo await db.collection(students).where({ openid: OPENID }).get(); return await db.collection(dorms).where({ building: studentInfo.data[0].building }).get(); } // 宿管只能查所负责楼栋 if (CUSTOMID.startsWith(dormmgr_)) { const mgrInfo await db.collection(dorm_managers).where({ customId: CUSTOMID }).get(); return await db.collection(dorms).where({ building: mgrInfo.data[0].building }).get(); } // 管理员查全部 return await db.collection(dorms).get(); };参数说明CUSTOMID由后台导入时生成非用户可控杜绝伪造所有角色查询均走where条件过滤而非get后在前端筛防止敏感字段泄露管理员导出 Excel 功能另设独立云函数调用前需二次扫码确认避免误操作。3. 云开发配置与数据库建模避开 90% 新手卡点的初始化清单3.1 云开发环境初始化地域、配额、安全规则三步定生死很多团队卡在第一步云开发控制台创建环境后小程序死活连不上。根本原因常是地域错配或安全规则未放行。必须按顺序执行地域锁定在微信开发者工具 → 云开发 → 环境设置中将「云开发默认地域」设为与控制台一致如ap-guangzhou配额检查进入云开发控制台 → 配额管理确认「云函数调用次数」和「云存储容量」未达上限学生测试期建议调至 50 万次/月、5GB安全规则补漏云数据库默认规则禁止所有读写必须为每个集合添加最小权限规则。例如dorms集合规则{ read: auth.openid ! (auth.openid data.owner || data.public true), write: auth.openid ! auth.openid data.owner }注意data.owner是文档中存储的openid字段非auth.openid。若文档无此字段规则永远不生效。3.2 数据库集合设计6 张表如何支撑全业务本系统共 6 个核心集合字段设计直击宿舍管理痛点集合名关键字段业务作用避坑提示studentsopenid,name,dormNo,building,phone,class学生主表关联报修、查寝dormNo格式统一为A-301避免A301/A-301混用导致查询失效repairsstudentOpenid,dormNo,status(0待处理/1处理中/2已完成),images,createdAt报修主表status用数字而非字符串云函数where查询更快dorm_managerscustomId,name,building,phone,avatar宿管信息building为数组支持一人管多栋数组字段查询必须用array-contains不能用noticestitle,content,publishTime,targetRole([all,student,dormmgr])公告定向推送targetRole为数组学生端where({ targetRole: _.in([all,student]) })check_recordsdormMgrOpenid,dormNo,gpsLat,gpsLng,checkTime,manual查寝记录含定位坐标gpsLat/gpsLng类型为number非string否则地图渲染失败admin_logsoperator,action,target,timestamp管理员操作审计日志所有字段必填action限定为create/update/delete便于日志分析3.3 云函数部署为什么必须用npm install --production本地调试时函数能跑通部署后却报Cannot find module xxx大概率是node_modules里混入了开发依赖如eslint、jest。正确部署流程# 进入云函数目录如 cloudfunctions/login cd cloudfunctions/login # 清理 node_modules 并只安装生产依赖 rm -rf node_modules npm install --production # 部署微信开发者工具内右键 → “上传并部署云端安装依赖” # 或命令行部署需安装 cloudbase-cli tcb fn deploy login --region ap-guangzhou参数说明--production参数跳过devDependencies减少包体积实测平均减小 62%--region必须与云开发环境地域一致否则函数无法访问同地域数据库部署后务必在云开发控制台 → 云函数 → 日志中查看首次调用日志确认无Error: Cannot find module。3.4 文件存储结构为什么图片路径要带角色前缀云存储路径设计影响权限与检索效率。本系统采用角色/业务/日期/文件名结构student/repair/20240520/abc123.jpg dormmgr/check/20240520/def456.jpg admin/notice/20240520/ghi789.jpg好处删除某学生所有报修图时只需deleteFile({ fileList: [student/repair/20240520/] })无需遍历宿管端相册列表可直接listFile({ prefix: dormmgr/check/ })避免拉取无关文件审计时按前缀统计各角色存储用量一目了然。4. 避坑指南上线前必须验证的 5 个血泪问题4.1 现象学生提交报修后宿管端收不到通知但数据库里状态已更新原因云函数updateRepairStatus中调用了wx.cloud.callFunction发送订阅消息但未在app.json中声明requiredPrivateInfos: [scope.subscribeMessage]导致消息发送权限被静默拒绝。解决在app.json的permission字段下添加permission: { scope.subscribeMessage: { desc: 用于及时通知报修处理进度 } }并在学生首次提交报修时用wx.requestSubscribeMessage主动申请模板消息权限模板 ID 需在公众号后台申请。4.2 现象查寝打卡时GPS 定位返回latitude: 0, longitude: 0原因安卓手机未开启「高精度定位模式」或微信未获取location权限iOS 需在info.plist中添加NSLocationWhenInUseUsageDescription。解决前端增加权限检测wx.getSetting({ success: (res) { if (!res.authSetting[scope.userLocation]) { wx.authorize({ scope: scope.userLocation }); } } });在project.config.json中确保minPlatformVersion: 8.0.0低版本微信不支持getLocation精度参数。4.3 现象管理员导入宿管 Excel 后宿管登录显示“无权限”但数据库dorm_managers表中数据正常原因导入脚本生成的customId为dormmgr_2024001但云函数中校验逻辑写成了CUSTOMID.startsWith(dormmgr)少一个下划线。解决统一所有角色前缀为student_/dormmgr_/admin_并在云函数校验处严格匹配if (CUSTOMID.startsWith(dormmgr_)) { /* 正确 */ } // 而非 if (CUSTOMID.startsWith(dormmgr)) { /* 错误会匹配到 dormmgr_test */ }4.4 现象云函数getNoticeList返回空数组但数据库notices表中有 3 条数据原因notices集合的安全规则中read条件写为auth.openid ! data.targetRole all但实际数据中targetRole是数组[all]而非字符串all。解决修改安全规则为read: auth.openid ! (data.targetRole all || _.in(data.targetRole, [all]))或更稳妥地统一targetRole为数组类型规则改为read: auth.openid ! _.in(all, data.targetRole)4.5 现象小程序在真机调试时一切正常体验版发布后首页白屏原因app.js中onLaunch里调用了未发布的云函数如initConfig但体验版环境未部署该函数导致try/catch外部异常中断启动流程。解决所有云函数调用必须包裹try/catch错误时降级处理try { const res await wx.cloud.callFunction({ name: initConfig }); } catch (e) { console.error(initConfig failed, use default config, e); app.globalData.config { theme: blue, noticeSwitch: true }; // 默认配置 }发布前用「体验版」环境在开发者工具中「真机调试」确认无Uncaught (in promise)报错。5. 真实场景下的数据看板与批量操作让管理员告别 Excel 手工统计5.1 报修响应时效看板从“大概几天”到精确到小时学生最常抱怨“报修一周没动静”。本系统在repairs表中记录createdAt和updatedAt云函数getRepairStats计算各环节耗时// cloudfunctions/getRepairStats/index.js const stats await db.collection(repairs).aggregate() .group({ _id: $status, avgHours: $.avg($.subtract([$updatedAt, $createdAt])), count: $.sum(1) }) .end(); // 返回结果示例 // [ // { _id: 0, avgHours: 2.3, count: 15 }, // 待处理平均2.3小时 // { _id: 1, avgHours: 8.7, count: 22 }, // 处理中平均8.7小时 // { _id: 2, avgHours: 4.1, count: 38 } // 已完成平均4.1小时 // ]参数说明$subtract计算毫秒差除以3600000得小时数管理员端图表用echarts-for-weixin渲染X轴为status文字待处理/处理中/已完成Y轴为avgHours若某状态avgHours 24自动标红并触发预警消息给管理员。5.2 批量导入导出宿管信息 Excel 的字段映射与容错管理员常需批量导入新学期宿管名单。Excel 模板强制要求列名为姓名,手机号,负责楼栋,头像URL注意无空格。导入云函数importDormMgrs关键逻辑// 解析 Excel 后对每行数据做清洗 const cleanRow (row) ({ name: row[姓名]?.trim(), phone: row[手机号]?.replace(/[^0-9]/g, ), // 去除括号、横线 building: Array.isArray(row[负责楼栋]) ? row[负责楼栋].map(b b.trim()) : [row[负责楼栋]?.trim()], // 支持单栋或逗号分隔多栋 avatar: row[头像URL] || /default-avatar.png }); // 插入前校验手机号格式 if (!/^1[3-9]\d{9}$/.test(cleanRow.phone)) { throw new Error(第${i}行手机号格式错误${cleanRow.phone}); }容错设计phone字段自动清洗兼容138-1234-5678、(138)12345678等格式building支持A栋,B栋输入自动拆分为数组导入失败时返回详细错误行号及原因如“第5行手机号为空”而非整批回滚。5.3 公告定向推送一次操作触达三类人群管理员发公告时勾选「学生」「宿管」「管理员」复选框后端生成三条独立记录targetRole字段分别为[student]、[dormmgr]、[admin]。推送逻辑// 云函数 sendNotice const targets event.targetRoles; // [student, dormmgr] const notices targets.map(role ({ title: event.title, content: event.content, targetRole: [role], publishTime: new Date() })); await db.collection(notices).add({ data: notices });优势学生端getNoticeList只查targetRole包含student的记录无冗余数据若某角色无用户如暂无宿管对应记录仍存在但不会推送给任何人避免空指针后续扩展「班级定向」只需新增targetClass: 计算机2022级字段无需改推送逻辑。5.4 离线数据同步查寝记录断网后如何不丢宿管在宿舍楼地下室打卡时常遇信号盲区。系统采用「本地缓存 定时同步」策略// app.js 中 onLaunch 启动同步定时器 let syncTimer null; const startSync () { syncTimer setInterval(async () { const offline wx.getStorageSync(offline_check); if (offline) { try { await submitToCloud(offline); // 提交成功则清除 wx.removeStorageSync(offline_check); } catch (e) { console.log(sync failed, retry later, e); } } }, 30000); // 每30秒尝试一次 }; // 页面卸载时清理 onUnload: () { if (syncTimer) clearInterval(syncTimer); }边界处理同步失败时offline_check保留下次启动继续尝试若连续 3 次失败弹窗提示“网络异常请检查后重试”避免无限重试耗电同步成功后submitToCloud函数返回服务端生成的recordId前端存入sync_log集合供审计追溯。从那以后我每次交付宿舍管理系统都会在上线前强制走一遍「断网打卡→恢复网络→检查记录是否同步」这个流程再让宿管在电梯里、楼梯间、地下室各测一次定位精度。不是信不过代码是信不过现实世界的信号基站。希望帮到你。本文还有配套的精品资源点击获取