Android 12获取剪贴板文本时应用崩溃问题求助

问题根源 #

从日志核心报错信息可直接定位原因：

Denying clipboard access to com.jery.tachisyrpc, the application is not in focus nor is it a system service for user 0

Android 10（API 29）起开始限制后台应用访问剪贴板，Android 12（API 31）进一步收紧权限：仅当前处于前台、获得焦点的应用能访问剪贴板。你的代码在onCreate生命周期中执行，此时Activity尚未完全获取焦点，剪贴板访问被系统拒绝，导致clipboard.getPrimaryClip()返回null，未初始化的clipItem调用getText()触发空指针异常。

解决方案 #

1. 调整访问时机 #

避免在onCreate、onStart等生命周期方法中直接访问剪贴板，改为在用户主动交互事件（如按钮点击）中执行，此时应用必然处于前台焦点状态。

2. 完善空指针防护 #

对剪贴板操作的每一步都做null判断，覆盖所有可能的异常场景，即使访问被拒也不会崩溃。

修改后的代码示例 #

// 示例：在按钮点击事件中执行剪贴板读取操作
yourButton.setOnClickListener(v -> {
    ClipboardManager clipboard = (ClipboardManager) getSystemService(Context.CLIPBOARD_SERVICE);
    String clipText = "";
    if (clipboard != null && clipboard.hasPrimaryClip()) {
        ClipData clipData = clipboard.getPrimaryClip();
        if (clipData != null && clipData.getItemCount() > 0) {
            ClipData.Item clipItem = clipData.getItemAt(0);
            if (clipItem != null && clipItem.getText() != null) {
                clipText = clipItem.getText().toString();
                Details.setText(clipText);
            }
        }
    }
});

3. 后台监听剪贴板（可选） #

若需后台监听剪贴板变化，Android 12+ 可使用ClipboardManager.OnPrimaryClipChangedListener，但需注意：

• 仅当应用回到前台时，监听回调才会触发
• 后台时监听会被系统暂停，需在生命周期中动态注册/移除

示例代码：

private ClipboardManager.OnPrimaryClipChangedListener clipChangeListener;

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    
    ClipboardManager clipboard = (ClipboardManager) getSystemService(Context.CLIPBOARD_SERVICE);
    clipChangeListener = () -> {
        // 回调触发时应用已处于前台，可安全访问剪贴板
        if (clipboard.hasPrimaryClip()) {
            ClipData clipData = clipboard.getPrimaryClip();
            if (clipData != null && clipData.getItemCount() > 0) {
                ClipData.Item clipItem = clipData.getItemAt(0);
                if (clipItem != null && clipItem.getText() != null) {
                    String clipText = clipItem.getText().toString();
                    Details.setText(clipText);
                }
            }
        }
    };
}

// 前台时注册监听
@Override
protected void onResume() {
    super.onResume();
    ClipboardManager clipboard = (ClipboardManager) getSystemService(Context.CLIPBOARD_SERVICE);
    clipboard.addPrimaryClipChangedListener(clipChangeListener);
}

// 后台时移除监听，避免内存泄漏
@Override
protected void onPause() {
    super.onPause();
    ClipboardManager clipboard = (ClipboardManager) getSystemService(Context.CLIPBOARD_SERVICE);
    clipboard.removePrimaryClipChangedListener(clipChangeListener);
}

内容的提问来源于stack exchange，提问作者Jery Js