uni.setclipboarddata在h5平台不执行且不触发fail回调，需先判断平台并用navigator.clipboard.writetext()等替代；fail回调中errmsg提示权限、隐私协议或数据类型问题；ios真机可能静默失败，须绑定用户点击事件；应封装copytext函数统一try/catch捕获各平台错误。
uni.setClipboardData 的 fail 回调不触发？检查是否漏了平台降级
uni.setClipboardData 在 H5 平台根本不会执行，也不会进 fail 回调——它只是个空函数。直接写 uni.setClipboardData({ data: 'xxx', fail: () => {} }) 在网页里等于没写。必须先判断平台再分路径：process.env.UNI_PLATFORM === 'h5' 或 uni.getSystemInfoSync().platform === 'h5'，然后走 navigator.clipboard.writeText() 或 document.execCommand('copy')。漏掉这层判断，就永远收不到失败信号。
fail 回调进了但 errMsg 模糊？重点看三类典型报错字符串
真正进到 fail 回调时，err.errMsg 通常暴露关键线索，别只看 console 报红：
-
"setClipboardData:fail no permission"：iOS 原生 App 没在manifest.json勾选「剪贴板」模块，或微信小程序没在后台声明「读取剪贴板」权限 -
"setClipboardData:fail api scope is not declared in the privacy agreement"：微信小程序隐私指引缺勾选，且未提交审核（清除缓存也无效） -
"setClipboardData:fail invalid data"：传了非字符串，比如number、null、undefined或带换行符的富文本；务必提前typeof data === 'string' && data.trim()
iOS 真机静默失败？不是没报错，是压根没触发 fail
iOS（包括微信内置浏览器）对剪贴板写入不抛异常，也不进 success/fail，而是直接丢弃调用——尤其当你在 async 函数里 await 后再调用，或放在 onLoad、setTimeout 里。这不是 bug，是系统拦截。验证方式很简单：把复制逻辑硬编码成 uni.setClipboardData({ data: 'test' })，绑在用户点击事件里，如果这时成功了，那问题 100% 出在异步上下文丢失。临时解法是 setTimeout(() => { uni.setClipboardData(...) }, 0)，但更稳妥的是把异步操作提前，确保点击那一刻数据已就绪。
如何统一捕获所有平台的剪贴板失败？靠 try/catch + 显式 fallback
别依赖 uni.setClipboardData 自带的回调做兜底，H5 和部分 iOS 场景它根本不走。正确做法是封装一个 copyText(text) 函数，内部按平台分层处理，并统一抛出可捕获的错误：
- H5：用
try { await navigator.clipboard.writeText(text) }，catch (e)判断e.name === 'NotAllowedError'（手势缺失）或'SecurityError'（非 HTTPS） - App/iOS：仍用
uni.setClipboardData，但fail回调里手动throw new Error(errMsg) - 微信小程序：同上，但需额外检查
errMsg是否含"privacy agreement"字样，引导用户去后台补权限
这样上层调用就能用标准 try/catch 捕获所有失败，不用散落各处写重复逻辑。最易忽略的是：H5 的 navigator.clipboard 错误类型和 uni API 完全不兼容，不包装就无法统一处理。
