uniCloud云函数无法添加图片水印，因其运行于Node.js环境，不支持Canvas API、DOM及图形渲染能力；水印必须在客户端通过uni.createCanvasContext等前端API完成绘制与导出。
uni-app 无法在 uniCloud 云函数里做图片水印合成 —— 所有水印必须在客户端（前端）完成，云函数只负责接收、存储和转发。
为什么 uniCloud 云函数不能加水印
uniCloud 运行环境是 Node.js（阿里云/腾讯云函数），不提供 Canvas API、DOM 或图形渲染能力。你传一张图过去，云函数连 ctx.drawImage 都调不了，更别说 fillText 或 canvasToTempFilePath —— 这些全是客户端专属 API。所谓“云上加水印”，本质是误读：水印只能在用户手机或浏览器里画，云函数顶多帮你存个带水印的文件。
- 云函数能做的只有：
uniCloud.uploadFile接收已加好水印的临时路径，或用第三方 SDK（如 OSS、七牛）做简单格式转换（缩略图、转 WebP），但不支持像素级编辑 - 试图在云函数里用
canvasnpm 包（如 node-canvas）会失败：缺少系统依赖（freetype、jpeg）、内存限制严、跨平台兼容性差，且 uniCloud 不开放底层系统权限 - 哪怕你硬塞进 base64 图片字符串，Node 端也没有
getImageData或绘图上下文，纯文本处理无法叠加文字/图标水印
正确的批量水印流程：客户端逐张绘制 + 并发上传
真正可行的路径是：用户选多图 → 前端逐张用 uni.createCanvasContext 加水印 → 得到带水印的 tempFilePath → 并发调用 uni.uploadFile 上传到 uniCloud。
- 必须用
Promise.all控制并发，但别无脑设成count: 9全量并发：iOS 真机常因内存不足卡死，建议控制在 3~5 路并发 - 每张图都要独立创建 canvas 上下文，复用同一个
canvas-id会导致上一张水印残留（尤其文字重叠） - 水印内容（如时间戳、订单号）必须在每张图绘制前动态生成，否则多图会套用同一份静态值
- 导出前务必调用
context.draw(true, callback)，true表示同步绘制，否则canvasToTempFilePath可能返回空白图
canvasToTempFilePath 失败的三大硬伤
这是全平台最常卡住的环节，失败不报错，只返回空路径或黑图。
-
canvas元素不能被display: none或visibility: hidden—— 即使藏在屏幕外，也要用position: fixed; left: -9999px - 微信小程序要求
canvas-id必须与uni.createCanvasContext('xxx')的字符串完全一致（大小写、空格、引号都不能差） - iOS 端单张图物理尺寸超 4096×4096 像素（如 iPhone 主摄图）会静默失败，必须先用
uni.getImageInfo拿到width/height，再按比例压缩到底层 canvas 尺寸（例如缩到 2000px 宽）
水印文字自动换行和定位的实际约束
uni-app 的 fillText 不支持自动换行，也没 textWrap 方法，必须手动拆分。
- 用
ctx.measureText(text).width测单字宽，结合 canvas 宽度算出每行最多几个字；中文按字符切，英文按单词切 - 斜向水印（如铺满背景的「SAMPLE」）必须用
ctx.translate(x, y)+ctx.rotate()+ctx.fillText('', 0, 0)，否则旋转中心偏移导致水印飞出画布 - 半透明背景框要用
ctx.setFillStyle('rgba(0,0,0,0.2)')，别碰setGlobalAlpha—— 它会影响后续所有绘制，包括文字颜色 - 字体渲染在 iOS 微信小程序有偏移 bug，固定字号（如 16px）+
setTextAlign('center')+setTextBaseline('middle')+ 手动算 x/y 坐标最稳
真正难的不是“怎么画水印”，而是让每张图在不同设备、不同分辨率、不同平台下都导出成功 —— 重点不在逻辑，而在 canvas 尺寸适配、dpr 缩放时机、导出触发顺序这些细节。漏掉任意一环，就可能某台安卓机上全白，某版 iOS 微信里文字错位。
