微信小程序真机复制失败主因是未在公众号后台声明剪贴板权限，需完成隐私指引配置并审核通过；iOS要求同步点击上下文调用；H5需降级适配；data参数必须为非空字符串。
微信小程序真机报 setClipboardData:fail api scope is not declared in the privacy agreement
这是最常见也最隐蔽的卡点：不是代码错了，是微信后台没声明权限。哪怕 manifest.json 和 app.json 都配好了，只要没在公众号后台走完隐私指引流程，真机就一定失败。
必须完成三步：
- 登录微信公众平台 → 左侧【设置】→【基本设置】→【服务内容声明】→【用户隐私保护指引】→【更新】→【增加信息类型】→ 勾选「读取剪贴板」
- 填写真实使用场景（如“用于复制邀请链接以便分享”），不能留空或写“其他用途”
- 生成新指引并提交审核；审核通过前，真机调用必报这个错误
改完后别忘了清除微信缓存：长按小程序图标 →「清除缓存」→ 重新进入。否则旧配置仍生效，白配。
iOS 微信里点击后 copy 失败，Android 却正常
iOS 对安全上下文要求最严——uni.setClipboardData 必须在用户点击的**同步执行栈内**调用。任何异步延迟（await、Promise.then、setTimeout）都会丢掉这个上下文，导致静默失败。
典型错误写法：
async copyWithLink() {
const link = await getShortLink(); // 这里已脱离点击上下文
uni.setClipboardData({ data: link }); // iOS 必 fail
}
可行方案：
- 把
uni.setClipboardData放在@click绑定的函数第一行，不加任何前置异步操作 - 如果必须先请求数据，用
setTimeout(() => { uni.setClipboardData(...) }, 0)强制回归同步上下文（实测有效，但非万能） - 避免在
onLoad、onShow或uni.onMemoryWarning等生命周期/系统回调中调用
H5 端调用 uni.setClipboardData 没反应也不报错
uni.setClipboardData 在 H5 平台是空实现，既不报错也不触发 success/fail 回调，纯静默失效。这不是 bug，是设计如此。
必须手动降级：
- 先判断环境：
uni.getSystemInfoSync().platform === 'h5' - 优先用
navigator.clipboard.writeText(text)，但需同时满足：window.isSecureContext === true（即 HTTPS 或 localhost）+ 调用在用户点击同步路径中 - 兜底用
document.execCommand('copy')：创建临时<input>，select()后调用，注意 iOS Safari 需补setSelectionRange(0, text.length)
漏掉任一条件，H5 复制就会“看起来点了但什么都没发生”。
传参为 number、null 或对象时 fail 且无提示
uni.setClipboardData 的 data 参数严格要求是**非空字符串**。传 123、{id: 1}、null 或 undefined 都会直接 fail，控制台通常只显示 setClipboardData:fail，不报具体类型错误。
务必加校验：
- 调用前做
if (typeof text !== 'string' || !text.trim()) { return; } - 数字转字符串用
String(num)或num + ''，别依赖隐式转换 - JSON 数据必须先
JSON.stringify(obj)，再 trim 空格 - 调试时加一行
console.log('copy data:', typeof text, text)，比猜快得多
真正难的不是写对那行 uni.setClipboardData，而是让整个调用链始终落在权限、平台、上下文、参数四重约束的交集里——少一个，真机就“没反应”。
