多台Android设备通过WiFi局域网连接问题排查

核心问题定位 #

客户端连不上热点里的服务器，主要原因集中在IP地址错误、服务器绑定范围不对、协程使用不规范、权限缺失这几个点，下面一步步解决：

一、先确定服务器在热点网络中的正确IP #

客户端不能通过getLocalIpAddress()获取服务器IP——这个方法拿到的是客户端自己的本地IP。

• 绝大多数Android设备开启热点后，服务器的默认IP是192.168.43.1，可以直接测试这个地址。
• 如果默认IP无效，去服务器设备的热点设置（高级选项里）查看AP的IP地址。

二、修正客户端代码中的问题 #

1. IP赋值错误
   把KtorClient.ipAddress直接设置为服务器的热点IP（比如192.168.43.1），不要用客户端自己的IP。
2. 弃用GlobalScope
   GlobalScope.launch不受生命周期管理，容易引发内存泄漏，换成和页面/ViewModel绑定的协程Scope：
   • Activity里用lifecycleScope.launch
   • ViewModel里用viewModelScope.launch
3. 取消HTTPS请求
   你的otherGetData()用了https，但服务器如果没配置SSL证书，必然连接失败，直接用http即可。
4. 开启详细日志排查
   在Ktor客户端配置里加上日志级别，方便查看连接失败的具体原因：

   val client = HttpClient(Android) {
       install(Logging) {
           level = LogLevel.ALL // 打印所有请求日志
       }
   }
   

三、服务器端必须做的配置 #

• 服务器的Ktor必须绑定到0.0.0.0，而不是127.0.0.1或单个本地IP，这样才能接收热点网络中客户端的请求：

  embeddedServer(Netty, port = 8080, host = "0.0.0.0") {
      routing {
          get("/api/data") {
              call.respondText("服务器返回数据")
          }
      }
  }.start(wait = true)
  

• 检查服务器设备的防火墙，确保8080端口没有被拦截。

四、权限配置 #

客户端和服务器都需要添加以下权限到AndroidManifest.xml：

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<!-- 安卓10及以上部分设备需要定位权限才能连接热点 -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" android:maxSdkVersion="32" />

五、测试流程（快速定位问题） #

1. 服务器开启热点，记下IP。
2. 客户端连接热点后，用系统浏览器访问http://服务器IP:8080/api/data：
   • 能正常显示内容：服务器没问题，问题出在客户端代码。
   • 无法访问：检查服务器绑定地址、端口、防火墙，或者换个端口试试。

修正后的客户端代码示例 #

// 在Activity中使用的示例
class MainActivity : AppCompatActivity() {
    private val client = HttpClient(Android) {
        install(Logging) {
            level = LogLevel.ALL
        }
    }

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        // 点击按钮触发请求，传入服务器热点IP
        findViewById<Button>(R.id.btn_fetch).setOnClickListener {
            fetchServerData("192.168.43.1")
        }
    }

    private fun fetchServerData(serverIp: String) {
        lifecycleScope.launch {
            try {
                val response = client.request("http://$serverIp:8080/api/data")
                val data = response.body<String>()
                Log.d("KtorClient", "DATA:$data")
                // 更新UI需切换到主线程
                withContext(Dispatchers.Main) {
                    findViewById<TextView>(R.id.tv_result).text = data
                }
            } catch (e: Exception) {
                Log.e("KtorClient", "请求失败: ${e.message}")
            }
        }
    }

    override fun onDestroy() {
        super.onDestroy()
        client.close() // 关闭客户端，释放资源
    }
}

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