现象
按钮里调用 navigator.CLIpboard.writeText 复制邀请码,本地开发正常,上线后部分用户点击没有任何反应。控制台报 NotAllowedError: Document is not focused 或 Write permission denied,而手动选中文字按复制却完全正常。
原因
剪贴板 API 要求安全上下文,http 页面直接不可用。它还必须在用户手势的调用栈里执行,经过 await 或者 setTimeout 之后手势已经失效,调用会被拒绝。页面处于 iframe 且没有 allow=Clipboard-write 权限时同样会失败。
解决步骤
第一步,先判断能力,再降级到 execCommand。失败时不要抛错给用户看,用隐藏的 textarea 选中文本执行复制,这条路在 http 页面也能用。
async function copy(text) {
if (navigator.clipboard && window.isSecureContext) {
try {
await navigator.clipboard.writeText(text);
return true;
} catch (e) {}
}
const ta = document.createElement("textarea");
ta.value = text;
ta.style.position = "fixed";
ta.style.opacity = "0";
document.body.appendChild(ta);
ta.select();
const ok = document.execCommand("copy");
ta.remove();
return ok;
}
第二步,不要在手势之外调用。点击事件里同步执行复制,不要先 await 一个接口再写剪贴板;确实要请求数据时,提前把文本准备好,或者让用户再点一次。
第三步,iframe 场景加权限。嵌入方在 iframe 上写 allow="clipboard-write",否则子页面怎么调都会被拒绝,这一点经常被忽略。
验证
在 http 测试域名和 https 正式域名各点一次,确认都能复制成功;再在微信内置浏览器里长按粘贴,结果应与邀请码完全一致,没有多余空格。
小结
复制失败多半是安全上下文和手势时效的问题。先走 clipboard API,失败降级 execCommand,注意调用时机和 iframe 权限,覆盖率就能拉满。
