Android中OkHttp请求触发NetworkOnMainThreadException问题排查求助

核心原因 #

android.os.NetworkOnMainThreadException 触发的本质是网络请求代码仍运行在主线程，你大概率搞反了线程分工：把网络请求放在了主线程执行，仅将UI更新逻辑放进子线程，或是线程嵌套逻辑出错。

常见错误场景与修正 #

典型错误代码（你的实现可能属于此类） #

比如错误地把网络请求放在runOnUiThread里执行：

runOnUiThread(new Runnable() {
    @Override
    public void run() {
        // 错误：网络请求在UI线程执行
        String response = sendNetworkRequest();
        displayWindow.setText(response);
    }
});

或是嵌套线程时逻辑混乱，导致网络请求仍落在主线程：

new Thread(new Runnable() {
    @Override
    public void run() {
        runOnUiThread(new Runnable() {
            @Override
            public void run() {
                // 错误：网络请求还是跑在UI线程
                String response = sendNetworkRequest();
                displayWindow.setText(response);
            }
        });
    }
}).start();

正确的线程分工逻辑 #

必须把所有网络IO操作放在子线程，获取到响应后，再切换回主线程更新UI：

new Thread(new Runnable() {
    @Override
    public void run() {
        // 子线程执行网络请求
        final String response = sendNetworkRequest();
        
        // 请求完成后，切回主线程更新UI
        runOnUiThread(new Runnable() {
            @Override
            public void run() {
                displayWindow.setText(response);
            }
        });
    }
}).start();

额外优化建议 #

• 推荐使用Coroutines（AndroidX/Kotlin官方推荐）、AsyncTask（简单场景）或OkHttp+Handler等更规范的异步方案，减少手动线程管理的出错概率。
• 确保所有涉及网络连接、数据流读写的代码，都完全在子线程中执行，主线程只负责UI渲染。

内容的提问来源于stack exchange，提问作者1 Mamedov