Android Studio应用调用AWS API Gateway触发NetworkOnMainThreadException错误

问题核心 #

从报错堆栈可以明确看到，错误根源是android.os.NetworkOnMainThreadException——你直接在主线程（UI线程）中执行了网络请求usersApiClient.connectionsPost()。Android系统禁止在主线程处理耗时网络操作，否则会造成UI卡顿甚至ANR（应用无响应），因此抛出该异常。

解决方案 #

将网络请求转移到后台线程执行，下面是几种实用的实现方式：

方式1：Kotlin协程（推荐，现代Android开发首选） #

利用协程可以简洁地实现异步操作，修改点击事件代码如下：

myButton.setOnClickListener {
    // 启动IO调度器的协程执行网络请求
    lifecycleScope.launch(Dispatchers.IO) {
        try {
            usersApiClient.connectionsPost()
            // 请求成功后切回主线程更新UI
            withContext(Dispatchers.Main) {
                showToast("请求成功！")
            }
        } catch (e: Exception) {
            withContext(Dispatchers.Main) {
                showToast("请求失败：${e.message ?: "未知错误"}")
            }
        }
    }
}

如果项目未引入协程依赖，需在build.gradle（Module级别）中添加：

dependencies {
    implementation "androidx.lifecycle:lifecycle-runtime-ktx:2.6.2"
}

方式2：Thread + runOnUiThread（轻量手动实现） #

手动创建后台线程执行请求，完成后切回主线程更新UI：

myButton.setOnClickListener {
    Thread {
        try {
            usersApiClient.connectionsPost()
            // 切换回主线程显示结果
            runOnUiThread {
                showToast("请求成功！")
            }
        } catch (e: Exception) {
            runOnUiThread {
                showToast("请求失败：${e.message ?: "未知错误"}")
            }
        }
    }.start()
}

方式3：AsyncTask（旧版兼容方案，不推荐新项目使用） #

如果需要兼容较老的Android版本，可以使用AsyncTask：

private inner class ApiRequestTask : AsyncTask<Void, Void, Boolean>() {
    override fun doInBackground(vararg params: Void?): Boolean {
        return try {
            usersApiClient.connectionsPost()
            true
        } catch (e: Exception) {
            e.printStackTrace()
            false
        }
    }

    override fun onPostExecute(result: Boolean?) {
        super.onPostExecute(result)
        showToast(if (result == true) "请求成功！" else "请求失败")
    }
}

// 点击事件中调用
myButton.setOnClickListener {
    ApiRequestTask().execute()
}

关键注意事项 #

• 所有网络操作必须放在后台线程，主线程仅负责UI更新
• 务必捕获网络请求的异常，避免程序崩溃
• 优先选择Kotlin协程，它比AsyncTask更灵活、可读性更高，符合现代Android开发规范

内容的提问来源于stack exchange，提问作者Phoenix DeVentures