Android真机调用uni.setClipboardData失败是因厂商系统静默拦截：需启用clipboard权限、确保前台焦点、绑定点击事件、清洗文本、防抖处理、适配WebView降级及埋点验证。
Android 真机调用 uni.setClipboardData 报 setClipboardData:fail 且无 fail 回调
这是 Android 厂商系统（尤其华为、小米、OPPO）的典型表现：不抛错、不进 success、Promise 卡在 pending，表面像“没反应”，实则是系统级静默拦截。根本原因不是代码写错，而是剪贴板访问被后台/非焦点状态限制，或原生模块未启用。
- 必须检查
manifest.json→「模块权限配置」→ 是否启用clipboard模块（对应android.permission.READ_CLIPBOARD和WRITE_CLIPBOARD） - 确认 App 处于前台焦点状态——切到后台再切回来，部分机型会重置剪贴板上下文，需用户重新点击触发
- 避免在
onShow或onResume中自动调用；哪怕只做一次，也必须绑定到@click或@tap事件第一层 - HBuilderX 3.9+ 编译后，检查
android/app/src/main/AndroidManifest.xml是否已注入 clipboard 权限声明；旧版本需手动补全
复制后粘贴内容为空或乱码（Android 特别明显）
Android WebView 对换行符、零宽字符、HTML 实体兼容性差，uni.setClipboardData 只做字面写入，不处理渲染逻辑。传入含 \n、 、\u200b 的字符串，粘贴时极易被截断或识别为非法格式。
Android Remote Control
下载
远程控制 Android 设备，支持截图、自动化操作手机 App 等功能。本应用使用 uiautomator2 作为底层框架，通过 ADB 连接设备，用户无需 Root（1）查看手机屏幕；（2）自动化操作手机 App；（3）远程安装/卸载应用……
- 强制清洗：用
text.replace(/[\r\n\t\s\u00A0\u200B]+/g, ' ').trim()统一空白并去首尾 - 若原始内容来自服务端 HTML，先剔标签：
text.replace(/]*>/g, '')，再清洗 - 避免传
number或null：调用前加if (typeof text !== 'string' || !text.trim())校验 - 长文本（>10KB）在部分中低端机型上会静默失败，建议提前
if (text.length > 8000) text = text.slice(0, 8000) + '…'
同一台 Android 手机，第一次成功、第二次开始报 fail no permission
这不是缓存问题，而是系统对“重复快速调用”的风控策略。尤其在短时间内连续复制（比如批量导出场景），华为/小米会主动降权，后续调用直接拒绝，且不触发 fail 回调。
- 加防抖：两次调用间隔至少 300ms，用
setTimeout或lodash.debounce包裹 - 不要复用同一个
Promise实例；每次调用都新建uni.setClipboardData({ data }) - 失败后不要立即重试，提示用户“请稍后重试”，并禁用按钮 500ms
- 可配合
uni.getSystemInfoSync().model做机型适配：对已知敏感机型（如 HUAWEI P40、Xiaomi 12）主动延长间隔至 800ms
H5 + Android WebView 混合环境复制完全失效
很多“App 内嵌 H5”场景下，WebView 是旧版 Chromium（如 69–75），既不支持 navigator.clipboard.writeText，又屏蔽了 document.execCommand('copy') 的 DOM 操作权限。此时 uni.setClipboardData 必然空转，而降级逻辑若没写全，就会彻底失联。
- 必须显式判断环境：
const { platform, webView } = uni.getSystemInfoSync()，不能只靠platform === 'h5' - 优先走
navigator.clipboard?.writeText，失败后创建临时<textarea></textarea>并select()，再调document.execCommand('copy') - 注意：某些 WebView 要求
textarea必须已挂载且 visible，可用position: fixed; left: -999px;隐藏但保留可操作性 - 最后兜底：展示“已复制”提示，并附带“请手动按 Ctrl+V 粘贴”文案，比强行报错更可靠
catch 里抓不到任何东西。得靠日志埋点 + 用户点击后延时 console.log('copy done?') 来确认是否真执行到了底层。 
