同一设备上两个Android应用Socket连接被拒问题排查求助

问题背景 #

开发者开发了两个Android应用：一个作为服务端（启动android.net.ServerSocket），另一个作为客户端（通过android.net.Socket连接预定义端口）。服务端应用根据生命周期（onResume/onPause）启停服务，客户端应用启动ForegroundService持续尝试建立连接。目前出现**连接被拒绝（Connection refused）**异常，核心疑问：

1. 这类跨应用Socket通信是否存在限制（比如需使用同一签名密钥签名两个应用）？
2. 排查该问题时应重点关注哪些方面？

更新1：运行环境 #

两个应用均运行在同一设备上。

更新2：尝试的解决方案及错误信息 #

已采纳方案实现客户端连接逻辑，代码如下：

private fun InetAddress.connect(
    port: Int,
    connectionTimeout: Int = SOCKET_CONNECTION_TIMEOUT_MILLIS,
    onConnect: Socket.() -> Unit = {}
) {
    val newSocket = Socket()
    val socketAddress = if(context.getMyIp()?.hostAddress == hostAddress){
        InetSocketAddress("127.0.0.1", port)
    } else {
        InetSocketAddress(this, port)
    }
    newSocket.connect(socketAddress, connectionTimeout)

    newSocket.use { it.onConnect() }
}

但错误仍存在，日志信息：

Connection to /192.168.0.22 is stopped due to failed to connect to localhost/127.0.0.1 (port 48564) from /127.0.0.1 (port 55828) after 5000ms: isConnected failed: ECONNREFUSED (Connection refused)

更新3：服务端核心代码 #

服务端创建ServerSocket的代码片段：

serverSocket = ServerSocket(DATA_STREAM_PORT)
serverSocket.soTimeout = DEFAULT_TIMEOUT
serverSocket.use { server ->
    while (!server.isClosed) {
        val client = server.accept()
        ...do smth
    }
}

问题解答 #

1. 跨应用Socket通信是否需要同一签名？ #

不需要。Android系统默认允许同一设备上的不同应用通过Socket通信，无需强制使用同一签名密钥。仅当应用涉及Android 11+的包可见性限制时，需在AndroidManifest.xml中添加<queries>标签声明目标应用，但这属于组件可见性范畴，不直接限制Socket连接。

2. 排查连接被拒绝的重点方向 #

结合当前场景与错误日志，重点核查以下维度：

• 服务端监听状态与端口匹配
  • 确认服务端DATA_STREAM_PORT与客户端连接的48564为同一端口，避免端口配置不一致
  • 检查onResume是否触发了ServerSocket初始化：添加日志确认serverSocket实例是否有效，监听逻辑是否执行
  • 注意ServerSocket的线程归属：server.accept()是阻塞调用，若在主线程执行会触发ANR，导致监听逻辑被系统中断；需确保服务端在独立子线程中启动ServerSocket
  • 核查soTimeout设置：若DEFAULT_TIMEOUT过短，会导致监听提前终止，无法持续等待客户端连接
• 监听地址的正确性
  • 错误日志显示客户端连接127.0.0.1:48564被拒绝，说明服务端未在回环地址上监听。默认ServerSocket(int port)会绑定0.0.0.0（所有网卡），但若服务端存在绑定特定网卡（如192.168.0.22）的逻辑，会导致回环地址无法连接。建议显式绑定0.0.0.0：

    serverSocket = ServerSocket(DATA_STREAM_PORT, 0, InetAddress.getByName("0.0.0.0"))
    

• 权限与系统限制
  • 尽管本地Socket通信通常无需INTERNET权限，但部分Android版本或定制ROM仍要求该权限，建议两个应用都在AndroidManifest.xml中添加：

    <uses-permission android:name="android.permission.INTERNET"/>
    

• 服务端生命周期管理
  • 检查onPause中是否正确关闭了ServerSocket：若服务端进入后台时关闭了监听，此时客户端连接必然被拒绝；需确保客户端尝试连接时，服务端处于前台（onResume已执行，监听正常运行）
• 端口占用情况
  • 验证48564端口是否被其他进程占用，可通过adb命令检查：

    adb shell netstat -an | grep 48564
    

内容的提问来源于stack exchange，提问作者Андрій Пугач