HandlerThread更新RecyclerView崩溃排查：键盘应用建议显示问题

兄弟，这种本地测不出但线上狂报崩溃的情况真的太闹心了！结合你说的场景——在showSuggestions里启动HandlerThread处理任务，再切回主线程更新RecyclerView，我帮你梳理几个最可能的问题点和对应的解决方案：

一、最可能的崩溃原因 #

1. 组件销毁后仍尝试更新UI #

当用户快速切换界面（比如退出键盘所在的页面），你的HandlerThread可能还在后台跑任务，等任务完成后去更新RecyclerView时，对应的Activity/Fragment已经被销毁，RecyclerView或者Adapter已经是null，直接调用就会触发空指针崩溃。

2. Handler持有外部类强引用导致的内存泄漏+崩溃 #

如果mSuggestionHandler是匿名内部类或者非静态内部类，它会持有外部组件（比如KeyboardActivity）的强引用。就算组件已经销毁，HandlerThread的消息队列里还有未处理的消息，就会导致组件无法被回收，甚至在后续处理消息时，调用已经销毁的UI组件引发崩溃。

3. 重复任务导致的竞争问题 #

用户快速输入时，会多次调用showSuggestions，如果每次都启动新的HandlerThread或者发送新的消息，可能会有多个任务同时执行，导致Adapter的数据被频繁覆盖，或者多个线程同时触发UI更新，引发异常。

二、针对性解决方案 #

1. 严格管理HandlerThread的生命周期 #

在组件销毁时（比如onDestroy方法），务必终止HandlerThread并清空消息队列：

@Override
protected void onDestroy() {
    super.onDestroy();
    // 安全终止HandlerThread，避免后台任务继续执行
    if (mSuggestionHandlerThread != null) {
        mSuggestionHandlerThread.quitSafely();
        try {
            mSuggestionHandlerThread.join();
            mSuggestionHandlerThread = null;
        } catch (InterruptedException e) {
            e.printStackTrace();
        }
    }
    // 清空所有未处理的消息
    if (mSuggestionHandler != null) {
        mSuggestionHandler.removeCallbacksAndMessages(null);
        mSuggestionHandler = null;
    }
}

2. 改用静态Handler+弱引用避免内存泄漏 #

把mSuggestionHandler改成静态内部类，并用弱引用持有外部组件，这样既不会泄漏内存，还能在处理消息前检查组件是否存活：

private static class SuggestionHandler extends Handler {
    private final WeakReference<YourKeyboardComponent> mComponentRef;

    public SuggestionHandler(YourKeyboardComponent component, Looper looper) {
        super(looper);
        mComponentRef = new WeakReference<>(component);
    }

    @Override
    public void handleMessage(Message msg) {
        YourKeyboardComponent component = mComponentRef.get();
        // 先检查组件是否存活、UI是否可用
        if (component == null || component.isDestroyed() || component.isFinishing()) {
            return;
        }
        // 这里处理任务结果，更新RecyclerView
        String resultWord = (String) msg.obj;
        component.updateSuggestionsRecyclerView(resultWord);
    }
}

3. 避免重复任务，确保同一时间只处理最新的输入 #

每次调用showSuggestions时，先移除之前的未处理任务，再发送新的任务，避免旧任务覆盖新结果：

private void showSuggestions(final String word) {
    // 移除所有未处理的消息/任务，只保留最新的
    mSuggestionHandler.removeCallbacksAndMessages(null);
    // 发送新的任务到HandlerThread
    mSuggestionHandler.post(() -> {
        // 这里执行获取输入建议的耗时逻辑
        List<String> suggestions = getSuggestionsFromSource(word);
        // 切回主线程更新UI
        mRecyclerView.post(() -> {
            // 再次检查RecyclerView和Adapter状态
            if (mRecyclerView.isAttachedToWindow() && mSuggestionAdapter != null) {
                mSuggestionAdapter.setData(suggestions);
                mSuggestionAdapter.notifyDataSetChanged();
            }
        });
    });
}

4. 更新UI前先检查组件状态 #

在更新RecyclerView之前，务必确认UI组件还处于可用状态：

private void updateSuggestionsRecyclerView(List<String> suggestions) {
    if (mRecyclerView == null || mSuggestionAdapter == null) {
        return;
    }
    // 检查RecyclerView是否还附着在窗口上
    if (!mRecyclerView.isAttachedToWindow()) {
        return;
    }
    // 最后再更新数据
    mSuggestionAdapter.setData(suggestions);
    mSuggestionAdapter.notifyDataSetChanged();
}

三、排查小技巧 #

如果Fabric能提供崩溃栈信息，一定要优先看！比如空指针是指向Adapter还是RecyclerView，或者是IllegalStateException（比如在非UI线程更新？不过你说用主线程，大概率是组件销毁后的问题）。如果栈信息缺失，先按上面的方案逐一排查，尤其是生命周期管理和弱引用这两点，能解决大部分这类线上崩溃。

内容的提问来源于stack exchange，提问作者Mateen Chaudhry