巡查类微信小程序这几年在物业管理、园区巡检、设备点检这些场景里用得越来越多。以为做个巡查小程序就是“画几个页面、填个表单”，其实真正落地时，很多细节会卡住——比如离线状态下数据怎么存、巡查路线怎么动态生成、照片压缩后清晰度够不够、多人同时巡查会不会冲突。下面我把这些点掰开揉碎讲清楚，从底层逻辑到操作步骤，尽量让你看完能直接上手。

一、核心功能模块：别只盯着“打卡”

做巡查小程序，一上来就做“扫码打卡+填写记录”，结果上线后发现根本用不起来。原因很简单：真实巡查场景里，巡查员可能同时要检查20个点位，每个点位有5项检查内容，而且有些项目（比如设备温度、噪音分贝）需要数值输入，有些（比如墙面裂缝）需要拍照。如果只做一个通用表单，巡查员操作起来非常痛苦。

我建议把功能拆成三层：

底层（数据层）：要支持离线缓存。微信小程序虽然有缓存API，但默认只有10MB，巡查照片一多就爆。解决办法是用wx.getFileSystemManager()把图片存到用户本地，同时把表单数据存到Storage里，等网络恢复后再用队列上传。这里有个坑：微信小程序的Storage在用户清理缓存时会被清掉，所以关键数据（比如巡查任务ID、已完成点位列表）最好同时存一份到云端。

中层（逻辑层）：路线规划。不是所有巡查都是固定路线。比如物业巡查，有时候需要临时增加一个漏水点位。我见过一个做法：后台用GeoJSON画好巡查区域，前端用腾讯地图SDK的“多边形内随机点”算法，每天自动生成一条不重复的路线，避免巡查员走固定路线产生疲劳。代码实现时注意：腾讯地图的SDK在微信小程序里需要先申请密钥，而且要用

上层（交互层）：拍照要带水印。很多巡查系统要求照片上显示时间、地点、巡查员姓名。微信小程序自带的camera组件可以拍照，但水印得自己画。我的做法是用canvas合成：先用wx.createCameraContext()拍照拿到临时路径，再用wx.createCanvasContext()把时间、经纬度（从wx.getLocation()获取）、用户昵称画上去。这步容易踩的坑是canvas在部分安卓机型上会闪退，解决办法是降低画布分辨率，比如用750*1334而不是原图尺寸。

二、数据同步：离线/在线切换的“心跳机制”

巡查场景里网络不稳定是常态——地下车库、电梯井、偏远厂区。如果小程序一断网就罢工，那和废了没区别。我推荐用“心跳+队列”的方案：

小程序启动后，每隔30秒发一个ping请求到服务器。如果连续3次ping不通，就认为处于离线状态。离线期间，所有巡查数据（包括文字、图片）先存到本地。等网络恢复后，按时间顺序逐个上传。这里有个关键点：图片上传不能和文字数据一起发。因为图片体积大，上传慢，如果文字和图片混在一个请求里，文字数据会被阻塞。正确做法是：先上传文字数据（服务器返回一个记录ID），再上传图片（把记录ID作为图片文件名的一部分）。这样就算图片上传失败，文字数据已经落库了。

另外，多人同时巡查时会有数据冲突。比如两个人同时修改同一个点位的检查结果。我的处理方式是“版本号机制”：每条巡查记录都有一个version字段，更新时带上当前version。服务器对比version，如果发现版本不一致（说明被别人改过），就返回冲突提示，让用户选择“覆盖”还是“保留”。这比简单的“后提交覆盖前提交”要靠谱得多。

三、照片处理的“三重压缩”

巡查照片有个特点：数量多、质量要求不统一。比如检查设备铭牌，需要高清照片看清上面的字；检查墙面裂缝，只需要能看到裂纹走向就行。如果所有照片都用原图上传，服务器磁盘很快会满，而且上传速度慢。我试过几种方案后，用了这个策略：

第一重：拍照时用camera组件的quality参数设为“low”，微信小程序默认的low模式会把图片压缩到200KB左右，但清晰度对于大多数巡查场景够用。

第二重：如果用户需要高清照片（比如拍设备铭牌），在拍照后弹出一个“增强”按钮。点击后用canvas把图片放大到原图的1.5倍，再重新保存。这样虽然文件体积变大了，但只在必要时才用。

第三重：上传前用wx.compressImage()再压缩一次，目标大小设为300KB。注意这个API在iOS和安卓上的压缩效果不同，iOS压缩后颜色会偏暗，安卓则偏亮。我的解决办法是在压缩前先把图片转为RGB模式（微信默认是sRGB），但微信小程序里没法直接改色彩模式，所以更实际的做法是：在后台图片处理服务里加一个“自动白平衡”的滤镜，上传后统一校正。

四、权限和角色：别让所有人都能改数据

巡查小程序最怕的就是“巡查员自己改自己的记录”。比如一个点位检查结果是“正常”，但巡查员手滑点成了“异常”，然后偷偷改回来。所以权限设计要细致：

巡查员角色：只能新增记录，不能修改或删除已提交的记录。如果填错了，只能重新提交一条“纠错记录”，原记录保留。

组长角色：可以修改自己组员的记录，但修改后要留日志（谁、什么时间、改了什么字段）。这个日志存在云数据库里，用wx.cloud.database()的watch功能可以实时同步给管理员。

管理员角色：可以查看所有数据，但也不能直接删除。删除操作要走“回收站”逻辑——先把数据标记为“已删除”，保留30天后自动清理。这30天里管理员可以在回收站里恢复数据。

角色判断我用的是微信小程序的云开发“自定义登录”。具体做法是：在云函数里用wxContext获取用户的openid，然后去数据库查这个openid对应的角色。注意不要把角色信息存在前端，因为前端代码可以被篡改。我见过有人把角色写在Storage里，结果用户用抓包工具改了角色就能看到所有数据，这非常危险。

五、一个容易忽略的细节：巡查任务的“生命周期”

很多巡查小程序做完后，运营人员会发现一个问题：巡查任务创建后，如果没人执行，就一直挂在那里。所以任务管理要加上“超时自动关闭”机制。我的做法是：后台创建任务时，设置一个“最晚完成时间”。到了这个时间点，云函数自动触发（用云开发定时触发器），把未完成的任务状态改为“已超时”，同时给巡查员发一条模板消息（需要提前在微信公众平台申请模板消息权限）。

另外，巡查任务最好支持“循环模式”。比如每天的9:00-10:00做一次巡查。这个用云开发的“定时触发器”配合“任务生成器”实现。具体步骤：

1. 在云函数里写一个createDailyTask函数，每天凌晨3点执行（避开高峰期）。

2. 函数里查询所有“循环任务”配置，根据配置生成当天的具体任务（包括点位、检查项、巡查员）。

3. 生成后把任务ID和巡查员的openid绑定，这样巡查员打开小程序时，首页就能看到“待执行任务”列表。

4. 如果某天巡查员请假，管理员可以在后台手动“转派”任务。转派时要注意：原巡查员的任务列表里要移除这个任务，新巡查员要收到通知。通知用微信小程序的subscribeMessage.send接口，但注意这个接口要求用户先订阅，所以第一次使用时得引导用户点击“订阅”按钮。

六、实测对比：云开发 vs 自建服务器

做巡查小程序，纠结用微信云开发还是自己搭服务器。我两个都试过，直接说结论：

云开发：适合50人以下的团队。优点是省事——数据库、存储、云函数都集成好了，不用管服务器运维。但缺点也很明显：云数据库的查询能力有限，比如你想按“巡查时间+点位名称+检查结果”三个条件联合查询，云开发只能用复合索引，而且索引数量有上限（默认25个）。另外，云存储的图片如果超过10万张，访问速度会明显下降，因为CDN预热需要时间。

自建服务器：适合200人以上的团队。推荐用Node.js+MySQL+Redis的组合。MySQL存结构化数据（巡查记录、用户信息），Redis存缓存（比如当前在线的巡查员列表、正在执行的任务）。图片存到阿里云OSS或腾讯云COS，然后用CDN加速。自建的好处是数据完全可控，比如你可以写复杂的SQL（关联查询、分组统计），而云开发只能用聚合操作，写起来很麻烦。但代价是运维成本高——要配置Nginx、处理HTTPS证书、做数据库备份。

如果团队人数在50-200之间，我建议用“混合方案”：核心数据（巡查记录、用户权限）放在自建服务器，非核心数据（图片、日志）存在云开发。这样既保证了关键数据的灵活性，又利用了云开发的存储优势。不过要注意：两个平台的数据同步要写中间件，比如用云函数的HTTP请求把数据转发到自建服务器。

七、上线后最容易出的三个“坑”

坑一：手机型号适配。巡查员用的手机五花八门，从iPhone SE到千元安卓机。我遇到过最离谱的是：某款安卓手机拍照后，照片的exif信息里没有方向字段，导致canvas画水印时图片是倒着的。解决办法是在拍照后用wx.getImageInfo()获取orientation值，如果是“up”就不处理，其他值则用canvas旋转。代码里要加try-catch，因为getImageInfo在某些老旧机型上会报错。

坑二：GPS定位漂移。在地下室或者高楼旁边，wx.getLocation()返回的经纬度可能偏差几十米。我的做法是：允许巡查员手动修正位置。具体是在地图上显示当前位置（用map组件的markers属性），如果偏差太大，巡查员可以拖拽marker到正确位置。拖拽后记录新的经纬度，同时标记为“手动修正”。这样后台统计时可以区分自动定位和手动定位的数据。

坑三：模板消息被滥用。微信对模板消息有严格限制：用户点击“订阅”后，只能发一条消息。所以不要每次巡查都发通知，只在关键节点发（比如任务超时、数据异常）。另外，模板消息的模板ID在微信公众平台申请后，要等审核通过才能用。审核周期一般是1-3个工作日，别等到上线前一天才去申请。

巡查小程序看着简单，但每个细节都影响实际使用体验。比如照片压缩的算法、离线数据的同步策略、权限的粒度控制，这些网上很难找到现成的答案。我上面这些经验都是从实际项目里踩坑踩出来的，你可以根据自己团队的情况调整。如果遇到具体问题，比如某个API在特定机型上不兼容，或者数据同步时出现死锁，欢迎随时交流。