简介这是一套面向计算机专业本科生毕业设计的微信小程序家政服务平台完整源码适用于管理系统类课程实践与小程序开发能力提升。资源涵盖用户端与管理端双模块支持保洁、家电清洗、月嫂、管道疏通等多类服务在线预约、支付、评价及资讯浏览解决传统家政服务信息不对称、流程繁琐等痛点。压缩包共1213个文件主体为175个JavaScript逻辑文件、134个Vue组件、119个Java后端接口、86个WXML页面结构与88个WXSS样式文件辅以SVG图标、PNG素材及JSON配置整体17.46MB目录结构规范含bat一键部署脚本与Eclipse项目配置文件。已有474人学习下载开发者可直接运行调试、理解前后端交互流程、复用组件结构并参考资质审核、订单状态机、评价反馈等业务模块实现逻辑。1. 这不是“套模板就能上线”的家政小程序而是要直面真实业务流的闭环系统你下载了一个叫“基于微信小程序的家政项目小程序(全套).zip”的压缩包解压后看到 pages、components、utils、project.config.json 一应俱全甚至还有 server 目录和 SQL 文件——但真把它丢进微信开发者工具里大概率跑不起来。原因很简单家政服务不是静态信息展示它必须串联用户预约、服务派单、师傅接单、位置调度、订单状态机、支付核销、评价闭环这六层硬逻辑。市面上大量所谓“家政小程序源码”只实现了首页轮播服务分类电话拨打连「下单时自动计算距用户5公里内可派师傅」这种基础能力都缺失。本文聚焦真实落地场景用原生微信小程序技术栈非 uni-app 封装层从零还原一个具备订单流转、实时状态同步、微信支付 v3 对接、服务地图定位能力的家政系统最小可行版本。适合已有小程序开发经验、正接手本地家政公司数字化改造的技术负责人或独立开发者。2. 搭建微信小程序的流程从 project.config.json 到云开发环境初始化2.1 微信小程序项目结构解析与关键配置项修正拿到 .zip 包后第一件事不是运行而是检查project.config.json中的appid和description字段。真实项目中该文件里的 appid 必须与你在微信公众平台注册的主体一致否则调试器会提示“未绑定开发者”且无法调用 wx.login 等接口。常见错误是源码包保留了作者的测试 appid需手动替换{ description: 家政服务预约平台, packOptions: { ignore: [] }, setting: { urlCheck: true, es6: true, enhance: true, postcss: true, preloadBackgroundData: false, minified: true, newFeature: true, coverView: true, nodeModules: true, autoAudits: false, uploadWithSourceMap: true, compileHotReLoad: false, useMultiFrameRuntime: true, useApiHook: true }, compileType: miniprogram, libVersion: 3.4.4, appid: wx1234567890abcdef, // ← 此处必须为你自己的 AppID projectname: jiazheng-prod, debugOptions: { hidedInDevtools: [] }, isGameTourist: false, simulatorType: wechat, simulatorPlugin: , condition: { search: { current: -1, list: [] }, conversation: { current: -1, list: [] }, game: { current: -1, list: [] }, miniprogram: { current: 0, list: [ { id: 0, name: 首页, pathName: pages/index/index, query: } ] } } }提示若libVersion版本低于 3.2.0将无法使用wx.getFuzzyLocation模糊定位和wx.openLocation的高精度参数建议升级至 3.4.4 或更高。可在微信开发者工具 → 详情 → 本地设置 → 调试基础库版本中验证。2.2 云开发环境初始化替代传统后端的最小部署路径家政项目最耗时的环节不是前端页面而是订单状态同步与师傅调度逻辑。用微信云开发CloudBase可跳过 Nginx Node.js MySQL 部署直接用云函数 云数据库实现核心业务。在开发者工具顶部菜单栏点击「云开发」→「开通云开发」选择按量付费初期日均订单 100 单时月费用约 ¥3–¥8。开通后需初始化以下三个核心集合集合名用途关键字段示例orders订单主表_id,userId,serviceType,address,status: pending | assigned | in_progress | completed,assignTime,completeTimeworkers师傅信息表_id,name,phone,skills: [保洁, 维修],location: {lng: 116.3, lat: 39.9},available: trueuser_profiles用户档案表_id,nickName,avatarUrl,realName,idCardNo实名认证必需注意workers表中的location字段必须为 GeoPoint 类型非字符串否则无法执行db.collection(workers).where({ location: db.GeoNear({ ... }) })地理位置查询。在云开发控制台 → 数据库 → 创建集合时字段类型需手动指定。2.3 微信小程序顶部导航栏高度适配与动态标题设置家政小程序常需根据服务类型切换页面标题如“空调清洗”页显示“空调清洗预约”“家电维修”页显示“家电维修预约”且顶部导航栏高度在不同机型上差异显著。原生小程序中wx.getSystemInfoSync().statusBarHeight仅返回状态栏高度而导航栏总高度 statusBarHeight 44px默认导航栏内容区。但 iOS 和部分安卓机型存在安全区域偏移正确做法是// pages/service-detail/service-detail.js Page({ data: { navHeight: 0, pageTitle: }, onLoad(options) { const systemInfo wx.getSystemInfoSync() const navHeight systemInfo.statusBarHeight 44 // 标准导航栏高度 this.setData({ navHeight, pageTitle: options.serviceName || 服务详情 }) // 动态设置标题兼容 iOS/Android 渲染时机 wx.setNavigationBarTitle({ title: this.data.pageTitle }) } })对应 WXML 中需预留导航栏占位!-- pages/service-detail/service-detail.wxml -- view classnav-bar styleheight: {{navHeight}}px; background: #fff; view classnav-title{{pageTitle}}/view /viewCSS 中.nav-bar需设position: fixed; top: 0; width: 100%; z-index: 999;避免内容被遮挡。3. 家政项目核心业务流从用户下单到师傅接单的完整状态机实现3.1 用户预约页地址选择 服务时间选择 实时师傅匹配家政服务的关键是“就近派单”不能让用户等 2 小时才确认师傅。在用户提交订单前需实时查询 5 公里内空闲师傅并预占名额。此逻辑不可放在前端必须由云函数执行防止恶意刷单// cloudfunctions/assignWorker/index.js const cloud require(wx-server-sdk) cloud.init() exports.main async (event, context) { const { userId, serviceType, address, lng, lat } event const db cloud.database() try { // 查询 5km 内空闲且具备该技能的师傅 const res await db.collection(workers).where({ available: true, skills: db.RegExp({ regexp: serviceType, options: i }), location: db.GeoNear({ geometry: db.GeoPoint({ longitude: lng, latitude: lat }), maxDistance: 5000 // 单位米 }) }).limit(1).get() if (res.data.length 0) { return { code: 404, msg: 暂无附近空闲师傅请稍后再试 } } const worker res.data[0] // 原子操作更新师傅状态为“已接单中”并创建订单 const orderResult await db.collection(orders).add({ data: { userId, serviceType, address, workerId: worker._id, status: assigned, assignTime: new Date(), createdAt: new Date() } }) // 更新师傅状态避免重复接单 await db.collection(workers).doc(worker._id).update({ data: { available: false } }) return { code: 0, data: { orderId: orderResult._id, worker: worker } } } catch (err) { console.error(assignWorker error:, err) return { code: 500, msg: 派单失败请重试 } } }说明db.GeoNear是云数据库地理索引查询需提前在workers集合的location字段上建立 2dsphere 索引控制台 → 数据库 → 集合 → 索引管理 → 新建索引 → 字段名location类型2dsphere。未建索引会导致查询超时。3.2 师傅端接单逻辑WebSocket 实时推送 状态双写校验用户下单后师傅端需秒级收到通知。微信小程序不支持原生 WebSocket必须通过云函数 云开发的「云调用」能力触发订阅消息。但更可靠的做法是在订单创建时向师傅微信 openid 发送服务通知需提前获取 openid 并存入workers表// 云函数 assignWorker 中追加接在订单创建后 const openId worker.openId // 师傅在注册时授权获取并存储 await cloud.openapi.subscribeMessage.send({ touser: openId, templateId: TEMPLATE_ID_HERE, // 在公众号后台申请的服务通知模板 page: /pages/order-detail/order-detail?orderId${orderResult._id}, data: { thing1: { value: 您有新的${serviceType}订单 }, time2: { value: new Date().toLocaleTimeString() } } })同时师傅端页面需监听订单状态变更// pages/worker-orders/worker-orders.js Page({ data: { orders: [] }, onLoad() { this.loadOrders() // 每 5 秒轮询一次生产环境建议改用 socket.io 封装的云函数长连接 this.timer setInterval(() this.loadOrders(), 5000) }, loadOrders() { const db wx.cloud.database() db.collection(orders).where({ workerId: wx.getStorageSync(workerId), status: assigned }).orderBy(assignTime, desc).get().then(res { this.setData({ orders: res.result.data }) }) }, onUnload() { clearInterval(this.timer) } })提示wx.getStorageSync(workerId)应在师傅首次登录时通过wx.login() 云函数解密encryptedData获取 unionId 后写入本地缓存确保身份唯一性。3.3 订单状态机五种状态的原子更新与防并发冲突家政订单状态流转必须严格遵循pending→assigned→in_progress→completed→rated。任何状态跳变都需校验前置状态防止“用户取消时师傅已开始服务”类并发问题。例如用户取消订单// cloudfunctions/cancelOrder/index.js exports.main async (event, context) { const { orderId, userId } event const db cloud.database() try { // 乐观锁只允许从 pending 或 assigned 状态取消 const res await db.collection(orders).doc(orderId).update({ data: { status: db.command.set(canceled), cancelTime: new Date() }, where: { userId, status: db.command.in([pending, assigned]) } }) if (res.stats.updated 0) { return { code: 400, msg: 订单状态不可取消可能已被接单或开始服务 } } // 若原状态为 assigned释放师傅 const order await db.collection(orders).doc(orderId).get() if (order.data.status assigned order.data.workerId) { await db.collection(workers).doc(order.data.workerId).update({ data: { available: true } }) } return { code: 0 } } catch (err) { return { code: 500, msg: 取消失败 } } }4. 微信小程序支付功能暂时无法使用v3 版本对接的绕行方案与合规要点4.1 支付功能暂时无法使用的真实原因与商户资质核查当你在小程序中调用wx.requestPayment却收到“支付功能暂时无法使用”提示90% 的情况是商户号未开通“JSAPI 支付”权限或主体资质不匹配。需逐项核查登录 微信支付商户平台 → 「产品中心」→ 「开发配置」→ 确认「JSAPI 支付」已开通「账户中心」→ 「商户信息」→ 核对「经营主体」是否与小程序注册主体完全一致个体户不能为公司小程序收款「API安全」→ 「API证书」→ 下载「微信支付平台证书」并上传至云开发用于 v3 接口签名「产品中心」→ 「APPID 账号管理」→ 确认当前小程序 AppID 已绑定且状态为「已启用」。注意若小程序类目为「家政服务」微信支付要求必须接入「微信支付分」能力用于信用免押否则审核不通过。需在商户平台开通「支付分」并配置分龄规则。4.2 小程序微信支付v3对接无可用的平台证书的解决路径错误提示“无可用的平台证书”意味着云函数中未正确加载证书。v3 接口必须用平台证书解密回调通知且证书需以 PEM 格式存入云开发存储// cloudfunctions/payOrder/index.js const fs require(fs) const path require(path) const crypto require(crypto) // 从云存储读取证书需提前上传 cert.pem 到云存储根目录 const certBuffer await cloud.downloadFile({ fileID: cloud://xxx.cert.pem // 云存储文件 ID }).then(res res.fileContent) // 构造 v3 签名头 const timestamp Math.floor(Date.now() / 1000).toString() const nonceStr Math.random().toString(36).substr(2, 12) const message POST\n/v3/pay/transactions/jsapi\n${timestamp}\n${nonceStr}\n${JSON.stringify(body)}\n const signature crypto.createSign(sha256) .update(message) .sign(privateKey, base64) // privateKey 为商户私钥同样需存入云存储 return { appId: wx123..., timeStamp: timestamp, nonceStr, package: prepay_id${prepayId}, signType: RSA, paySign: signature }提示privateKey和cert.pem不可硬编码在代码中必须通过云存储或环境变量注入。云开发环境变量不支持二进制故推荐存入云存储并设置读权限为「仅管理员」。4.3 支付能力已被限制的应急方案离线核销 余额抵扣组合若支付功能长期受限如个体户资质不足可采用「用户预存余额 线下核销」模式过渡用户在小程序「我的钱包」中通过银行卡/支付宝充值资金进入云数据库user_balance表下单时优先扣减余额余额不足部分提示「请到店支付」师傅端 APP 扫码核销生成含订单号的二维码扫码后调用云函数更新orders.status// 核销云函数 exports.main async (event, context) { const { orderId, workerId } event const db cloud.database() // 双重校验订单状态为 assigned 且师傅匹配 const order await db.collection(orders).where({ _id: orderId, status: assigned, workerId }).get() if (order.data.length 0) return { code: 403 } await db.collection(orders).doc(orderId).update({ data: { status: in_progress, startTime: new Date() } }) return { code: 0 } }此方案规避了微信支付合规审查同时保障资金流可控。5. 微信小程序抓包与调试Burp Suite 抓取 PC 端微信小程序的真实流量分析5.1 Burp Suite 抓取 PC 端微信小程序的配置要点PC 版微信Windows/macOS小程序底层仍走 WebView 渲染可通过 Burp Suite 代理截获其 HTTP/HTTPS 流量但需绕过 SSL Pinning。关键步骤微信 PC 版安装目录中找到WeChat.exe→ 右键「属性」→ 「兼容性」→ 勾选「以管理员身份运行」否则无法注入证书Burp Suite 中开启 Proxy → Options → Import / export CA certificate → 导出cacert.der用 OpenSSL 转换为 PEMopenssl x509 -inform DER -in cacert.der -out cacert.pem将cacert.pem安装为系统根证书Windowscertmgr.msc → 受信任的根证书颁发机构 → 导入微信 PC 版设置 → 通用设置 → 网络 → 代理服务器 → 填写127.0.0.1:8080Burp 默认端口启动 Burp → Proxy → Intercept → Off避免阻断微信自身心跳包在微信中打开目标家政小程序 → Burp 的 Proxy → HTTP history 中筛选host包含tencent或weixin的请求。提示PC 微信小程序的 User-Agent 为Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36 MicroMessenger/3.8.0.23(0x63080017) NetType/WIFI MiniProgramEnv/Windows WindowsWechat可据此过滤。5.2 家政小程序关键接口识别与参数逆向抓包后重点分析三类接口接口类型示例 URL关键参数逆向目的地址解析https://apis.map.qq.com/ws/geocoder/v1/?address...keyxxxaddress,key替换为高德地图 API腾讯地图 key 有效期短订单创建https://api.xxx.com/order/createtoken,sign,timestamp分析签名算法常见 HMAC-SHA256 时间戳 随机串位置上报https://api.xxx.com/worker/locationlng,lat,accuracy验证是否使用wx.getLocation的type: gcj02坐标系例如发现sign参数由md5(userId timestamp secretKey)生成则云函数中需同步该逻辑const crypto require(crypto) const sign crypto.createHash(md5) .update(${userId}${timestamp}YOUR_SECRET_KEY) .digest(hex)5.3 小程序反编译风险提示与代码保护实践网络上流传的“家政小程序源码”多为反编译产物反编译得到的app-service.js已被混淆变量名 a/b/c/d且关键逻辑如支付签名、定位加密被抽离至miniprogram_npm目录。自行反编译存在法律风险且无法还原原始工程结构。真正有效的保护方式是敏感逻辑如坐标加偏、价格计算移至云函数前端只传参使用微信小程序「代码保护」功能开发者工具 → 详情 → 项目设置 → 勾选「代码保护」关键 API 请求头添加自定义字段如X-App-Ver: 1.2.3后端校验版本号。注意代码保护仅增加反编译难度无法杜绝。商业项目务必签署《源码交付协议》明确禁止二次分发与反编译行为。本文还有配套的精品资源点击获取