Android Socket聊天应用出现Java.net.BindException错误求助

问题场景 #

这是一款单Activity客户端-服务器Socket聊天应用，用户可选择「服务器」或「客户端」模式。选择服务器模式时，需输入端口与用户名，点击连接后等待客户端接入，成功后跳转至聊天界面。但点击连接按钮运行时出现Java.net.BindException错误，怀疑问题出在协程部分，代码如下：

fun onConnectClicked(
    viewModel: AppViewModel,
    navHostController: NavHostController
) {
    if (_ip.value.isNullOrBlank()) {
        // Server
        CoroutineScope(Dispatchers.IO).launch {
            try {
                server = ServerSocket(port.value!!.toInt())
                CoroutineScope(Dispatchers.Main).launch {
                    viewModel.onStatusChanged("The Server is accepting requests")
                }
                socket = server!!.accept()
                CoroutineScope(Dispatchers.Main).launch {
                    viewModel.onStatusChanged("Connection Established with $socket")
                }
            } catch (e: Exception) {
                Log.i("tag", e.toString())
            }
        }
    }
    else {
        // Client
        CoroutineScope(Dispatchers.Main).launch {
            try {
                socket = Socket(ip.value.toString() ,port.value!!.toInt())
                CoroutineScope(Dispatchers.Main).launch {
                    viewModel.onStatusChanged("Sending request to Server...")
                }
                CoroutineScope(Dispatchers.Main).launch{
                    viewModel.onStatusChanged("Connection Established with Server")
                }
            }
            catch (e: BindException) {
                Log.i("tag",e.toString())
            }
        }
    }
//        bufferedReader = BufferedReader(InputStreamReader(socket!!.getInputStream()))
//        printWriter = PrintWriter(socket!!.getOutputStream())

    navHostController.navigate(Screen.Chat.route)
}

错误原因分析 #

1. BindException 核心原因：这个异常通常表示指定端口已被其他进程占用，或者同一进程内重复尝试绑定同一个端口（比如多次点击连接按钮，重复创建ServerSocket）。
2. 协程与导航时机错误：当前代码中navHostController.navigate直接写在协程外部，协程是异步执行的，这会导致还没完成Socket连接就跳转至聊天界面，后续操作可能因socket未初始化而崩溃，同时也掩盖了连接过程中的错误。
3. 协程作用域不规范：使用CoroutineScope(Dispatchers.IO)这种自定义作用域，没有绑定生命周期，容易导致协程泄漏，尤其是在页面销毁后仍在执行网络操作。
4. 客户端线程错误：客户端的Socket连接放在Dispatchers.Main线程执行，Android禁止在主线程进行网络操作，会触发NetworkOnMainThreadException，同时错误捕获只针对BindException，无法处理其他连接异常。

修复方案 #

1. 解决端口占用问题 #

• 确保使用的端口未被系统或其他应用占用（建议使用1024以上的端口）；
• 添加重复点击判断，避免多次创建ServerSocket绑定同一端口；
• 连接失败时释放已创建的ServerSocket资源。

2. 修正协程与导航逻辑 #

• 使用viewModelScope作为协程作用域，绑定ViewModel生命周期，避免泄漏；
• 将导航操作移至连接成功的回调中，确保只有建立连接后才跳转至聊天界面；
• 客户端网络操作切换至Dispatchers.IO线程。

3. 完善错误处理 #

• 服务器端捕获BindException并针对性处理（提示端口占用）；
• 客户端捕获更通用的IOException，覆盖连接失败的各种场景；
• 错误信息同步更新至ViewModel，反馈给用户。

修正后的代码 #

fun onConnectClicked(
    viewModel: AppViewModel,
    navHostController: NavHostController
) {
    // 避免重复点击
    if (server != null || socket != null) {
        viewModel.onStatusChanged("Already connected or connecting")
        return
    }

    val portInt = port.value?.toIntOrNull()
    if (portInt == null) {
        viewModel.onStatusChanged("Invalid port number")
        return
    }

    if (_ip.value.isNullOrBlank()) {
        // Server Mode
        viewModel.viewModelScope.launch(Dispatchers.IO) {
            try {
                server = ServerSocket(portInt)
                withContext(Dispatchers.Main) {
                    viewModel.onStatusChanged("The Server is accepting requests")
                }
                socket = server!!.accept()
                withContext(Dispatchers.Main) {
                    viewModel.onStatusChanged("Connection Established with $socket")
                    // 连接成功后再跳转
                    navHostController.navigate(Screen.Chat.route)
                }
                // 初始化读写流
                bufferedReader = BufferedReader(InputStreamReader(socket!!.getInputStream()))
                printWriter = PrintWriter(socket!!.getOutputStream())
            } catch (e: BindException) {
                withContext(Dispatchers.Main) {
                    viewModel.onStatusChanged("Port $portInt is already in use")
                }
                Log.i("tag", "Bind Error: ${e.message}")
                server?.close()
                server = null
            } catch (e: Exception) {
                withContext(Dispatchers.Main) {
                    viewModel.onStatusChanged("Server connection failed: ${e.message}")
                }
                Log.i("tag", "Server Error: ${e.toString()}")
                server?.close()
                server = null
                socket?.close()
                socket = null
            }
        }
    } else {
        // Client Mode
        val ip = _ip.value ?: return
        viewModel.viewModelScope.launch(Dispatchers.IO) {
            try {
                withContext(Dispatchers.Main) {
                    viewModel.onStatusChanged("Sending request to Server...")
                }
                socket = Socket(ip, portInt)
                withContext(Dispatchers.Main) {
                    viewModel.onStatusChanged("Connection Established with Server")
                    // 连接成功后再跳转
                    navHostController.navigate(Screen.Chat.route)
                }
                // 初始化读写流
                bufferedReader = BufferedReader(InputStreamReader(socket!!.getInputStream()))
                printWriter = PrintWriter(socket!!.getOutputStream())
            } catch (e: IOException) {
                withContext(Dispatchers.Main) {
                    viewModel.onStatusChanged("Failed to connect to server: ${e.message}")
                }
                Log.i("tag", "Client Error: ${e.toString()}")
                socket?.close()
                socket = null
            }
        }
    }
}

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