Android Activity onCreate中Clipboard paste方法读取失效问题

问题表现 #

Android 系统剪贴板存在如下可复现的异常表现：通过 Handler 调度执行 paste 方法可正常获取剪贴板内容，但在 Activity 的 onCreate、onStart 生命周期回调中直接调用 paste 方法时，无法正常读取到剪贴板内容。

对应代码实现 #

Activity 核心代码 #

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_verify_files);
    initView();

    Log.e("TAG", "onCreate1: " + C.paste(Verify_files.this) );
    new Handler(getMainLooper()).postDelayed(new Runnable() {
        @Override
        public void run() {
            Log.e("TAG", "onCreate2: " + C.paste(Verify_files.this) );
        }
    },400);
}

实际日志输出 #

日志显示首次在 onCreate 中直接调用 paste 方法时，主剪贴板检测结果为 false；延迟 400ms 通过 Handler 主线程调度调用时，检测结果为 true，可正常获取剪贴板文本，日志内容如下：

E/##CC: paste: false
E/TAG: onCreate1: 
E/##CC: paste: true
E/TAG: onCreate2: THIS IS TEXT TO PASTE

剪贴板工具类实现 #

public static void copy(Context context , String text){
    Log.e(TAG, "copy: "+text );
    ClipboardManager clipboard = (ClipboardManager) context.getSystemService( CLIPBOARD_SERVICE);
    ClipData clip = ClipData.newPlainText("label", "THIS IS TEXT TO PASTE");
    clipboard.setPrimaryClip(clip);
    Toast.makeText(context,text+"",Toast.LENGTH_SHORT).show();
}

public static String paste(Context context  ){
    ClipboardManager clipboard= (ClipboardManager) context.getSystemService(CLIPBOARD_SERVICE);
    Log.e(TAG, "paste: "  +clipboard.hasPrimaryClip() );
    if(clipboard.hasPrimaryClip()) {
        ClipData clip = clipboard.getPrimaryClip();
         if (clip != null) {
            ClipData.Item item = clipboard.getPrimaryClip().getItemAt(0);
            return item.getText() + "";
        }
    }
    return  "";
}

问题产生原因 #

这个现象是 Android 系统的隐私保护机制导致的，不是代码bug：

• 从 Android 10（API 29）开始，系统禁止未处于用户可感知前台焦点状态的应用读取剪贴板内容，防止后台应用静默窃取用户粘贴的敏感信息。
• Activity 的 onCreate、onStart 生命周期触发时，窗口还未完成附着、没有获得用户交互焦点，系统会判定当前应用还不满足剪贴板读取的前台状态要求，因此调用 hasPrimaryClip() 会直接返回 false，拒绝返回剪贴板内容。
• 之前代码中延迟400ms调用能成功，本质是刚好等过了Activity的初始化窗口期，等窗口拿到焦点、系统放开剪贴板权限后才执行读取，和延迟时长没有必然关系——如果设备性能较差，400ms时Activity还未获得焦点，同样会读取失败。

无延迟可靠实现方案 #

不需要依赖固定时长的延迟调用，可通过以下两种稳定方案实现初始化阶段正常读取剪贴板：

• 方案1：将剪贴板读取逻辑移到 onWindowFocusChanged 回调中执行。这个回调触发时代表Activity窗口已经拿到输入焦点、完全处于前台可交互状态，系统不会拦截剪贴板访问，示例代码：

@Override
public void onWindowFocusChanged(boolean hasFocus) {
    super.onWindowFocusChanged(hasFocus);
    // 仅在首次获得焦点时执行读取，避免重复触发
    if (hasFocus) {
        String clipContent = C.paste(Verify_files.this);
        Log.e("TAG", "onWindowFocus: " + clipContent);
    }
}

• 方案2：如果必须在 onCreate 阶段触发读取逻辑，使用无延时的主线程post将读取任务抛到主线程消息队列尾部，等待当前主线程队列中所有生命周期、窗口绘制相关的系统任务执行完成后，再执行剪贴板读取。这种方式没有固定等待时长，不会因为设备性能差异出现偶发失败，示例代码：

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_verify_files);
    initView();
    // 替换固定延时post，直接抛到消息队列尾部
    new Handler(getMainLooper()).post(new Runnable() {
        @Override
        public void run() {
            Log.e("TAG", "onCreatePost: " + C.paste(Verify_files.this) );
        }
    });
}

补充注意：Android 12及以上版本对剪贴板权限管控更严格，只有当前真正获得用户输入焦点的前台应用/默认输入法，才有读取剪贴板的权限，任何后台、非焦点状态下的读取请求都会被系统直接拦截。

内容的提问来源于stack exchange，提问作者Rohaitas Tanoli