uni.setClipboardData在H5端不支持，调用后静默失败；必须降级使用navigator.clipboard.writeText（HTTPS/localhost环境、用户手势触发）或document.execCommand('copy')（兼容旧版Safari），并严格满足安全上下文、同步触发和字符串清理三要素。
uni.setClipboardData 在 H5 页面调用后静默失败
这不是你代码写错了，而是 uni.setClipboardData 根本不支持 H5 平台——它在 H5 下既不报错，也不触发 success 或 fail 回调，直接“消失”。很多开发者在浏览器里点按钮没反应，反复检查逻辑却漏掉了这个前提。
必须主动降级：H5 端只能用原生 API，且有两个主流选择：
-
navigator.clipboard.writeText()：现代标准，返回 Promise，但要求 HTTPS 或localhost环境，且必须由用户手势（如@click）触发 -
document.execCommand('copy')：兼容旧版 Safari（iOS 12 及更早），但已废弃，需配合textarea临时插入 DOM 才能生效
别再把 uni.setClipboardData 直接塞进 H5 页面里了，它在那里就是个无效空操作。
H5 复制失败的三个硬性条件没满足
即使你用了 navigator.clipboard.writeText，仍可能报 NotAllowedError 或静默失败。根本原因不是代码问题，而是浏览器策略卡死：
- 页面未部署在 HTTPS 下（或非
localhost）：开发时用http://127.0.0.1:8080也会被拒绝，必须是https://或http://localhost - 调用不在用户手势上下文中：不能在
setTimeout、Promise.then、onLoad里调，必须紧贴点击事件回调（例如@click="handleCopy"的函数体内） - 文本内容含非法字符或未清理：比如富文本解析后残留
\n、\t，某些浏览器会拒绝写入剪贴板；建议统一做text.replace(/[\r\n\t\s\u00A0]+/g, ' ').trim()
跨平台复制函数怎么写才真正可靠
不能靠 if-else 简单分支，要兼顾异常捕获、平台判断、降级兜底。一个最小可用封装如下：
async copyText(text) {
if (!text) return;
// 清理空白符
const cleanText = text.replace(/[\r\n\t\s\u00A0]+/g, ' ').trim();
try {
if (uni.getSystemInfoSync().platform === 'h5') {
await navigator.clipboard.writeText(cleanText);
} else {
await uni.setClipboardData({ data: cleanText });
}
uni.showToast({ title: '已复制', icon: 'none' });
} catch (err) {
console.error('复制失败:', err);
// H5 fallback：尝试 execCommand（仅当 writeText 不可用时）
if (uni.getSystemInfoSync().platform === 'h5') {
const textarea = document.createElement('textarea');
textarea.value = cleanText;
textarea.readOnly = true;
textarea.style.position = 'absolute';
textarea.style.left = '-9999px';
document.body.appendChild(textarea);
textarea.select();
document.execCommand('copy');
document.body.removeChild(textarea);
}
uni.showToast({ title: '复制失败', icon: 'none' });
}
}
注意：await 必须加，否则 Promise 拒绝会被吞掉；catch 里补 execCommand 是给老 Safari 的最后保障，不是主路径。
微信小程序真机复制失败的隐藏配置项
如果你在 H5 没问题，但微信小程序真机点不动，大概率不是代码问题，而是权限没开：
- 检查
manifest.json中mp-weixin节点下是否有"permission": { "scope.writeClipboard": { "desc": "用于复制内容" } } - 确认小程序后台「接口权限」里已开启「剪贴板」功能（账号管理 → 接口权限 → 剪贴板）
- 体验版/开发版能复制、正式版不能 → 一定是后台权限未提交审核或审核未通过
App 端同理：iOS 需在 manifest.json → App 模块配置 中勾选「剪贴板」；Android 部分厂商系统（如华为、小米）若关闭「后台运行」权限，也会导致剪贴板静默失效。
