OkHttp MockWebServer独立运行时外部客户端无法连接问题求助

我在Android Espresso UI测试中成功运行OkHttp MockWebServer，一切正常。现在想把该MockWebServer作为独立服务运行在本地主机，让Appium、浏览器等客户端连接获取模拟响应，同时复用已编写的Mock代码，不想使用Wiremock这类工具。

我的方案是在单独的Java/Kotlin项目中构建独立Jar包，通过命令行在本地运行，但无法连接服务器显示的URL地址，ping命令提示找不到服务器。

错误信息 #

ping http://kubernetes.docker.internal:62037 
Ping request could not find host http://kubernetes.docker.internal:62037. Please check the name and try again.

现有代码 #

MockServer代码 #

object MockServer {

fun init() {
    GlobalScope.launch(Dispatchers.IO) {
        val mockWebServer = MockWebServer()
        mockWebServer.start()
        println("Server url: " + mockWebServer.url("").toString())
    }
}

主类代码 #

fun main(args: Array<String>) {
   MockServer.init()
   println("MockServer running")
   Thread.sleep(30000) // main thread is sleeping but server is running in different thread
   println("MockServer exit")
   exitProcess(0)
}

1. 修正Ping命令的使用错误 #

Ping是ICMP协议工具，不能带http://前缀，也无法测试端口连通性。正确的测试命令：

• 先测试主机解析：ping kubernetes.docker.internal
• 如果主机解析失败，直接使用本机的局域网IP（比如192.168.1.100）替代该主机名

2. 修改MockWebServer绑定地址，允许外部访问 #

默认情况下，MockWebServer的start()方法会绑定到localhost（仅本机回环地址），导致其他客户端（如Appium模拟器、局域网设备）无法访问。需要修改为绑定到0.0.0.0（监听所有网络接口）：

修改后的MockServer代码：

import okhttp3.mockwebserver.MockWebServer
import kotlinx.coroutines.GlobalScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.launch
import java.net.InetAddress

object MockServer {
    fun init() {
        GlobalScope.launch(Dispatchers.IO) {
            val mockWebServer = MockWebServer()
            // 绑定到所有网络接口，允许外部设备访问
            val bindAddress = InetAddress.getByName("0.0.0.0")
            mockWebServer.start(bindAddress, 0) // 0表示随机分配可用端口
            
            // 获取本机局域网IP，方便外部客户端访问
            val localIp = InetAddress.getLocalHost().hostAddress
            val port = mockWebServer.port
            println("MockServer可访问地址：")
            println("- 本机：http://localhost:$port")
            println("- 局域网：http://$localIp:$port")
        }
    }
}

3. 优化主线程阻塞逻辑 #

原代码用Thread.sleep(30000)固定30秒后退出，无法长期运行。改成让主线程持续阻塞，直到收到中断信号（如Ctrl+C）：

修改后的主类代码：

fun main(args: Array<String>) {
    MockServer.init()
    println("MockServer运行中，按Ctrl+C停止服务")
    // 让主线程持续阻塞，直到收到中断信号
    try {
        Thread.currentThread().join()
    } catch (e: InterruptedException) {
        println("MockServer正在停止...")
        exitProcess(0)
    }
}

4. 检查防火墙设置 #

确保本地防火墙（Windows Defender防火墙、macOS防火墙等）允许Java程序的入站连接，或者临时关闭防火墙测试连通性。如果需要长期运行，可以手动添加防火墙规则，允许对应端口的TCP入站请求。

5. 验证连通性 #

服务器启动后，用浏览器访问输出的http://<本机IP>:<端口>，如果能看到MockWebServer的默认响应（通常是404，因为还没配置Mock规则），说明服务正常可访问。

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