无后端的人格测试小程序:当「数据不出设备」变成架构约束,我学到了什么

TL;DR

复盘一个已上线的个人项目「3Q 工具箱-人格测试」(uni-app + Vue3 + TS,微信/抖音双端,全程无服务器):如何在零后端约束下实现跨设备契合度对比(自设计编码格式)、3~5 人群矩阵、Canvas 分享海报链路,以及一路踩过的编码、Canvas、布局三类真实的坑。不是教程文,是踩坑实录,欢迎评论区交流。

1. 为什么坚持无后端

先交代背景:个人主体小程序,产品主张「纯本地计算」------答题记录全在 uni.setStorageSync,带 schema 版本迁移;没有账号体系;用户间数据交换不走服务器,而是把数据编码进分享参数。

这个约束一半来自成本(不想运维),一半来自产品叙事:隐私是它的核心卖点之一,「架构必须与主张自洽」。一旦引入云端中转,「数据不出设备」这句话就不成立了。

代价是:所有「看起来需要服务器」的功能,都得在前端+参数层面解决。

2. 跨设备对比:编码格式设计的三个教训

双人契合度对比的载体是一个自设计的邀请码(转发卡片 query 携带):

python 复制代码
2.{tidIdx+verIdx+personaIdx+match, 6位定长}.{全维度 2 位定宽连写}.{2位 hex 校验和}

维度值按模块 dims 表顺序连写,接收方持有同一份枚举表还原 key,不传 key 省长度。校验用乘 31 折叠散列取低 8 bit------不是安全机制,只是传输完整性兜底。

教训一:字符集先于编码。 v1 格式用逗号分隔维度值,结果 encodeURIComponent 把 , 变成 %2C,各端基础库对 query 的解码次数不一致,校验和按原文计算就炸了------部分用户的分享卡打开就报「邀请无效」,且只有部分转发链路能复现。v2 重构为只含 [0-9.] 与 hex 的字符集,编码前后完全等价,问题根除。编码格式的第一个设计输入应该是传输层的不确定性,不是紧凑性。

教训二:版本位从一开始就要有。 格式第一段就是版本号,v1 仅兼容读取不再生成------已转发出去的旧卡片不能变成垃圾。如果当初没留版本位,这次迁移就只能「通知所有历史用户重新分享」(做不到)。

教训三:失败分级要按用户视角给文案。 解码失败分 empty/format/version/checksum/payload 五级,每个级别对应一句「请让对方重新发送」变体------用户不关心 checksum 是什么,关心的是「我该干什么」。

群对比(3~5 人)直接复用这套载荷:每人本机生成邀请码 → 群里互发 → 发起者粘贴 → 前端完成两两契合度(欧氏距离分档)→ Canvas 渲染上三角矩阵 + 导出海报。全程零请求。

3. Canvas 链路踩坑实录

所有分享海报(单人结果、双人对比、群矩阵)都是 Canvas 2D 现场绘制的,三个印象深刻的坑:

坑一:包内图片的加载路径。 createImage 的 src 直接写 /static/... 包内路径,在开发者工具里会被解析成 __pageframe__/components/canvas-export/static/...(相对组件目录),直接 500。uni.getImageInfo 中转同样不可靠。最终稳定方案:

php 复制代码
const fsm = wx.getFileSystemManager()
fsm.readFile({ filePath: pkgPath, encoding: 'base64' })
// → data:image/png;base64,... → img.src = dataURL

data URL 没有路径歧义,工具与真机都稳。教训:小程序 canvas 里凡是「画包内资源」,base64 是唯一让我不再回来修的路。

坑二:异步落笔与导出时序。 码图是异步加载后 drawImage 的,而 exportToTempFile 是同步触发的------不 await 绘制 Promise,导出的图必然 缺图。每张海报页都要维护一个 qrReady Promise,导出前 await 它;加载失败不能缓存失败结果(否则当次会话永不重试)。

坑三:布局常量与画布尺寸解耦。 海报布局按某个画布高度排了字面量(底部区块 y=512、537),而画布高度来自平台配置(当时还是 500)------底部整块画到画布外,测试的时候没人看第 500 像素以下。修法:底部区块一律相对 H 定位,并给布局函数配了纯函数单测(几何断言:区块都在画布内、互不重叠)。

4. 值得抄的两个产品化设计

  • 「结果会变」的产品化:同模块测 ≥2 次,历史页渲染 sparkline 折线(匹配度/维度切换),文案直言「这不是不准,是你在变化」。技术上只是纯函数 + Canvas 折线,但它先发制人消解了所有人格测试必被问的问题。
  • 合规当设计输入:娱乐向定位写进产品红线(文案不出现医疗暗示/智商情商字样),合规约束反过来限制了技术选型(个人主体不申请订阅消息、不引入云开发做推送,召回全靠站内提醒位)。

5. 最后

项目已上线(微信「3Q 工具箱-人格测试」),娱乐向产品,官方定位写得很诚实:「人格测试是娱乐,不是判决」。

如果你也在做「零运维 + 隐私优先」的独立产品,这条「本地存储 + 参数化数据交换 + Canvas 生成物」的路线可以参考。参数编码的容错设计、Canvas 的 base64 方案这两块坑我算是替大家踩完了------评论区欢迎交流,也在找同类约束下的项目交流设计取舍。

相关推荐
李纲明6 小时前
微信小程序开了 Skyline 后样式全乱、滚动对不上甚至部分组件不能用?Skyline 怎么接才稳
javascript·微信小程序·小程序·devdiy
李纲明6 小时前
微信小程序等位大桌被小桌占掉或过号回来就闹:先核桌型分队与过号容忍次数,再查门口屏与推送同源
微信小程序·devdiy·等位排队·桌型分队·过号重排·门口屏·推送同源
李纲明18 小时前
微信小程序团课临开课才取消或空位没人补:先核取消时限与自动释放,再查候补确认与预扣回滚
微信小程序·devdiy·团课预约·取消时限·空位释放·候补确认·预扣回滚
用户034187671381 天前
用秒哒做了个拍照识餐小程序,上线两周踩的 4 个坑
微信小程序
李纲明1 天前
微信小程序租赁归还说本来就坏或配件对不上:先核借还点验与随单存证,再查差异计价公示
微信小程序·devdiy·租赁点验·借还拍照·随单存证·差异计价·押金释放
李纲明2 天前
微信小程序次卡跨店对不上账或前台随手改余次:先核流水只增不改与统一日切,再查冲正权限与总部只读
微信小程序·devdiy·核销流水·跨店次卡·日切对账·冲正权限·总部只读
李纲明2 天前
微信小程序维修拆机后口头加价或未确认就开工:先核验机快照与报价确认,再查补充报价与取机核验
微信小程序·devdiy·维修验机·报价确认·报价快照·补充报价·取机核验
wx1qq1com2 天前
一桩带几台车:共享租赁桩位配比、取电与结算闭环设计
物联网·微信小程序·小程序
李纲明2 天前
微信小程序场地长租月底对不上或口头占场撞场:先核合约预约与核销流水出账,再查附加费与转租归属
微信小程序·devdiy·场地长租·月结账单·核销流水·附加费·转租归属