安卓12+需手动开启厂商隐私设置中的剪贴板权限、确保页面聚焦且由用户点击触发、清洗零宽字符并采用800ms轮询间隔，否则uni.getclipboarddata将静默返回空字符串。
安卓12+调用uni.getClipboardData失败，大概率是权限被拒或未声明
安卓12（API 31）起，android.permission.READ_CLIPBOARD被移除，系统改用运行时隐式授权——但uni.getClipboardData底层仍依赖READ_PHONE_STATE或READ_MEDIA_IMAGES等间接权限来绕过限制。很多项目在升级 targetSdkVersion 后突然读不到剪贴板，根本原因不是 API 变了，而是权限链断了。
- manifest.json 的「Android 模块权限配置」中必须勾选「剪贴板」模块（HBuilderX 自动注入
android.permission.READ_CLIPBOARD兼容层） - 若同时调用了
plus.device.getInfo()或其他需要READ_PHONE_STATE的接口，需额外申请该权限；否则部分厂商（如小米、OPPO）会拦截剪贴板读取 - 调用前务必检查：
if (!plus.android.hasPermission('android.permission.READ_PHONE_STATE')) { uni.showToast({ title: '请开启手机状态权限' }); }
uni.getClipboardData在安卓12真机返回空字符串的典型场景
不是代码写错了，而是系统策略卡在三个关键点上：用户没点“允许”、页面没聚焦、内容含零宽字符。尤其要注意，安卓12+ WebView 对非前台页面的剪贴板访问更敏感，哪怕页面只是被弹窗遮挡半秒，getClipboardData 就可能静默返回空。
- 必须由用户点击事件直接触发，不能放在
onShow、onLoad或定时器里 - 读取后立即做清洗：
data.replace(/[\u200b-\u200f\u202a-\u202f]/g, '').trim()，微信/钉钉转发口令常带\u200b，看着像空字符串 - 某些安卓12设备（如三星 One UI 5.1）要求输入框已获得焦点再读取，可加临时
input.focus()+this.$nextTick触发
轮询监听剪贴板变化在安卓12上的性能与稳定性妥协
安卓12 不允许后台服务持续读剪贴板，所以 App 端所谓“自动识别”只能靠前台轮询。但轮询间隔不能照搬旧方案——太密触发系统限频，太疏用户感知卡顿。实测下来，800ms 是多数安卓12设备的平衡点，低于 600ms 容易被系统 kill 掉定时器。
- 只在
onShow启动：this.pollTimer = setInterval(() => { /* 调用 getClipboardData 并比对 */ }, 800) - 必须在
onHide清除：clearInterval(this.pollTimer); this.pollTimer = null;，否则切到后台后首次返回前台时，定时器可能已失效或重复启动 - 防抖要加两层：一是内容比对需忽略空白符差异；二是连续变化只触发一次识别（比如用户快速复制多个链接），避免高频回调阻塞 UI
为什么有些安卓12手机点了“允许”还是读不到？
因为厂商定制系统把剪贴板权限藏得更深。华为 EMUI、小米 HyperOS、OPPO ColorOS 都把「剪贴板访问」单独列在隐私设置里，且默认关闭。用户点系统弹窗的“允许”，只开了基础权限，没开这个独立开关。
- 检测方式：调用
uni.getClipboardData后如果fail回调里err.errMsg包含"permission denied"，基本可判定是此问题 - 引导文案不能只说“去设置开启权限”，要具体到路径：例如「设置 → 隐私 → 权限管理 → 剪贴板 → 允许」
- 无法用 JS 跳转到该页面（安卓无标准 Intent），只能提示用户手动操作；iOS 同理，但路径是「设置 → 隐私与安全性 → 剪贴板」
轮询间隔、权限路径、零宽字符清洗——这三处不细调，安卓12 上的剪贴板读取就永远在“有时行、有时不行”的玄学状态。别指望一次配置全端通，每个厂商 ROM 都有自己的一套逻辑。
