uni.setClipboardData 报错主因是缺权限声明、平台不支持或调用上下文错误：微信需隐私指引声明+app.json权限配置；H5需降级为navigator.clipboard或execCommand；iOS须用户点击同步执行且传纯字符串。
直接说结论：uni.setClipboardData 报错，90% 不是代码写错了，而是缺权限声明、平台不支持或调用上下文不对。别急着改函数逻辑，先查这三块。
微信小程序报 fail api scope is not declared in the privacy agreement
这是最常见也最容易被忽略的错误。微信从基础库 2.21.0 起强制要求在用户隐私指引中声明剪贴板用途，否则直接拦截 API。
- 必须登录微信公众平台 → 左侧「设置」→「基本设置」→「服务内容声明」→「用户隐私保护指引」→「更新」→「增加信息类型」→ 勾选「读取剪贴板」并填写使用目的（如“用于分享链接时快速复制”）
- 同时要在项目
app.json中补上权限字段，否则真机仍会报fail no permission：{ "permission": { "scope.userclipboardwrite": { "desc": "用于保存内容到剪贴板" } } }
H5 端调用 uni.setClipboardData 完全没反应
因为 H5 平台根本没实现这个 API——它只是个空壳。控制台可能静默失败，也可能报 API setClipboardData is not yet implemented。
- 不能只写
uni.setClipboardData，必须按平台分路径：用uni.getSystemInfoSync().platform判断当前环境 - H5 下优先走
navigator.clipboard.writeText()（需 HTTPS + 用户手势触发），失败再 fallback 到document.execCommand('copy')（兼容 IE/旧版 Safari） - 注意：不能在
mounted或异步回调里直接调用，必须绑定在用户点击事件中（如@click="copyText('xxx')"）
iOS 微信/Safari 复制失败但 Android 正常
iOS 对剪贴板 API 的安全限制更严格：必须在用户点击的**同步执行栈内**调用，任何 await 或 setTimeout 都可能中断上下文。
- 避免在复制前加异步操作，比如
const link = await getShortLink()后再复制，会导致 iOS 失败 - 如果必须异步获取内容，可用
setTimeout(() => { uni.setClipboardData(...) }, 0)强制回到同步上下文（实测有效，但非万能） - 确保传入
data是纯字符串，不要传 HTML 片段、对象或带换行符的富文本内容，否则粘贴后格式异常或为空
报错 setClipboardData:fail no permission 或静默失败
除了微信隐私声明，还有几个隐蔽点容易漏：
- App 端（尤其华为、小米等定制系统）可能需要手动开启「后台运行」或「剪贴板访问」权限，否则在后台或锁屏后调用会失败
-
uni.setClipboardData只接受String类型参数，传数字、对象、null或undefined都会失败，建议加类型校验：if (typeof text !== 'string') return - 所有调用必须包裹
try/catch或提供fail回调，否则 Promise reject 会被吞掉，你只能看到 console 无输出
真正麻烦的不是怎么写复制逻辑，而是每个平台都在用不同规则卡你：微信要声明、H5 要降级、iOS 要守时序、安卓要看厂商权限。跨平台不是写一次跑 everywhere，是写四次，再各修三次。
