
文章分类:新闻资讯 发布时间:2026-11-16 原文作者:小程序开发 阅读( )

做小程序这些年,被问得最多的问题之一就是电子签名怎么搞。尤其是做租赁合同、物流签收、金融开户这类业务,用户画个押比打一堆字管用得多。但真动手去实现,你会发现坑不少:手指画出来的线条锯齿严重、签名区域跟页面滚动打架、生成的图片背景是黑的、上传服务器还得考虑压缩和格式。这篇就把微信小程序电子签名从技术选型到上线落地的完整流程拆开聊一遍,都是实际项目里踩过的坑。
先说说技术方案怎么选。市面上做小程序电子签名的路子无非三种:纯Canvas手写、第三方签名SDK,以及最近比较火的微信原生签名组件。纯Canvas最灵活,什么笔锋效果、压感模拟都能自己调,但代码量不小,光是处理touch事件和贝塞尔曲线就得写上百行。第三方SDK省事,但小程序包体积本来就紧张,引一个SDK动辄几百KB,还得考虑它跟基础库版本的兼容性。原生签名组件是2023年之后微信放出来的能力,调用简单,但样式定制空间有限,适合对签名外观要求不高的场景。我的建议是:如果只是简单的签收确认,用原生组件五分钟搞定;如果需要笔锋、多色、橡皮擦这些功能,老老实实上Canvas。
Canvas方案的核心逻辑其实不复杂。页面上放一个canvas标签,监听touchstart、touchmove、touchend三个事件。touchstart记录起点坐标,touchmove时把当前点和上一个点连成线,touchend结束当前笔画。听起来简单,但有两个细节不注意就会翻车。第一是坐标获取,小程序里touch事件返回的是相对于页面的坐标,而canvas绘制用的是画布内部坐标,两者需要通过canvas的getBoundingClientRect做转换,否则你画出来的线跟手指位置是偏的。第二是锯齿问题,直接用lineTo连线在快速滑动时会出现明显折线,正确做法是用二次贝塞尔曲线,取前一个点和当前点的中点作为控制点,这样线条才平滑。
再说说签名区域的交互设计。很多人忽略了一点:用户在签名时手掌很容易碰到屏幕,导致页面跟着滚动。解决办法是在canvas上绑定catchtouchmove而不是bindtouchmove,阻止事件冒泡。另外签名区域的高度别太小,实测低于200px用户签起来很别扭,尤其是中老年人。背景色建议用浅灰或白色,笔迹用深色,这样对比度高,后期生成图片也清晰。还有一个容易忽略的点:小程序在iOS和安卓上的touch事件触发频率不一样,iOS大概60Hz,安卓有些机型只有30Hz,这会导致同样快速划一笔,安卓上采集到的点更少,线条看起来更生硬。解决办法是在touchmove里做插值补偿,两个采样点之间手动插入中间点。
签名数据怎么存是个关键决策点。Canvas本身不存储笔画数据,它只是一块画布。用户签完之后,你有两个选择:一是直接导出成图片,二是保存笔画路径数据。导出图片用wx.canvasToTempFilePath,注意要指定fileType为png,并且把destWidth和destHeight设成跟canvas实际尺寸一致,否则会模糊。这里有个大坑:canvasToTempFilePath默认导出的图片背景是透明的,在深色背景下看就是一片黑。解决办法是在绘制签名之前,先给canvas填充一层白色背景。保存笔画数据的方案更适合需要“重放签名过程”的场景,比如法律存证,你把每个点的坐标、时间戳、压力值存成JSON,后期可以完整还原签名轨迹。
图片生成之后就是上传和存储。小程序的wx.canvasToTempFilePath生成的是临时文件路径,重启小程序就没了,必须上传到服务器。上传用wx.uploadFile,注意这个接口不支持Promise,得手动包一层。图片大小方面,一个正常签名导出的png大概在20KB到80KB之间,如果用户签得复杂可能超过100KB。建议在上传前做一次压缩,用canvas的toDataURL指定quality参数,或者用pressImage。服务器端收到之后一般存两样东西:图片文件本身存OSS或CDN,签名记录存数据库,包括用户ID、签名时间、关联的业务单据号。如果涉及法律效力,还得存一份签名的哈希值,用SHA-256就行,后面验签的时候比对哈希。
法律合规这块绕不开。国内电子签名法要求可靠的电子签名需要满足四个条件:签名人身份可识别、签名行为由签名人控制、签名后对签名内容的任何改动可被发现、签名数据电文的格式和内容可还原。翻译成技术语言就是:你得做实名认证(至少手机号+短信验证码)、签名过程要有时间戳、签名后的合同文件要做防篡改(哈希或区块链存证)。很多开发者只做了画布签名,后面这些全不管,真出了纠纷上法庭,这个签名是站不住脚的。建议至少接入一个第三方存证服务,成本不高,但关键时候能救命。
聊聊性能优化和兼容性测试。Canvas在小程序里是个重资源组件,如果页面上同时有地图、视频、富文本,签名区域可能会出现卡顿或白屏。解决办法是把签名页面做成独立页面,别跟其他重型组件混在一起。兼容性方面,重点测三种机型:iPhone SE这种小屏、华为Mate系列这种大屏,以及红米Note系列这种中低端安卓机。小屏主要看签名区域会不会被键盘遮挡,大屏看笔迹跟手性,中低端机看绘制帧率。另外微信基础库版本也得注意,canvas 2d接口在2.9.0之后才支持,如果你的用户里还有用老版本的,得做降级处理或者提示升级微信。
回到标题说的全流程,其实电子签名这事技术难度不算高,难的是把细节抠到位。从坐标转换到贝塞尔平滑,从透明背景到图片压缩,从实名认证到存证哈希,每一步单拎出来都不复杂,但串在一起任何一个环节出问题,用户那边就是“签不了”或者“签出来是黑的”。我的观点是:别一上来就追求笔锋效果和多色画笔,先把基础的手写、导出、上传跑通,再逐步加功能。上线前一定找几个真实用户在真实网络环境下测一遍,比你在开发者工具里点一百次都管用。