Kivy Android应用出现Socket超时错误的排查求助

核心问题 #

实时物体检测应用在PC端运行正常，但通过Buildozer打包为Android应用后，出现Socket连接超时错误，纯Socket测试应用也存在相同问题。

排查方向与解决步骤 #

1. 网络连接与IP配置问题 #

• 局域网IP错误：客户端硬编码的self.host_ip = "192.168.56.1"可能并非服务器在当前局域网的真实IP，服务器通过socket.gethostbyname(host_name)获取的IP可能是虚拟机或本地回环地址，而非WiFi局域网IP。
  • 解决：手动通过ipconfig/ifconfig确认服务器的局域网真实IP，替换客户端硬编码值；或在客户端添加IP输入界面，让用户手动输入服务器IP，避免硬编码固定值。
• 网络隔离：确保手机与服务器处于同一WiFi网络，关闭服务器端防火墙（或添加规则允许777、555端口的TCP连接），同时确认手机未开启VPN。

2. Android网络权限与线程问题 #

• 权限申请时机错误：原代码在build()中直接发起Socket连接，但Android权限申请是异步操作，连接发起时INTERNET权限可能尚未获取。
  • 解决：将Socket连接逻辑延迟到权限申请成功后执行，示例修改：

    def build(self):
        layout = MDBoxLayout(orientation='vertical')
        self.text= "CONNECTING..."
        self.image = Image()
        layout.add_widget(self.image)
        self.label = MDLabel(text=self.text,
                             adaptive_height = True,
                             halign='center', valign='middle')
        layout.add_widget(self.label)
    
        self.counter = 0
        self.client_socket = None
        self.data_socket = None
        self.host_ip = "192.168.x.x"  # 替换为服务器真实局域网IP
        self.port = 777
        self.port2 = 555
        self.data = b""
        self.payload_size = struct.calcsize("Q")
    
        if platform=="android":
            from android.permissions import request_permissions, Permission
            request_permissions([Permission.INTERNET], self.on_permissions_granted)
        else:
            self.on_permissions_granted()
        
        return layout
    
    def on_permissions_granted(self, permissions=None, grant_results=None):
        # 权限获取成功后初始化连接
        self.client_socket = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
        self.data_socket = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
        try:
            self.client_socket.connect((self.host_ip, self.port))
            self.data_socket.connect((self.host_ip, self.port2))
            self.label.text = "CONNECTED"
            # 启动定时任务
            Clock.schedule_interval(lambda dt: self.update_data(self.data_socket), 1/2)
            Clock.schedule_interval(lambda dt: self.update_frame(self.client_socket), 1.0 / 30.0)
        except socket.error as e:
            self.label.text = f"CONNECT FAILED: {str(e)}"
    

• 主线程阻塞：Android禁止在主线程执行网络操作，原代码在build()中直接调用connect()会阻塞主线程，导致连接超时或ANR。
  • 解决：使用threading模块将Socket连接逻辑放在子线程中执行。

3. Buildozer配置与依赖问题 #

• OpenCV依赖适配：直接指定opencv可能导致Android版本不兼容，建议使用适配移动端的版本。
  • 解决：修改Buildozer的requirements：

    requirements = python3,kivy,kivymd,opencv-python-headless,datetime
    

• 缺失网络状态权限：添加网络状态权限辅助应用检测网络环境。
  • 解决：更新Buildozer配置：

    android.permissions = INTERNET,ACCESS_WIFI_STATE,ACCESS_NETWORK_STATE
    

4. Socket超时设置 #

Android网络环境下，未设置超时可能因延迟导致连接失败，建议添加超时配置：

self.client_socket.settimeout(10)  # 设置10秒连接超时
self.data_socket.settimeout(10)

5. 服务器端监听配置 #

服务器端绑定的IP可能限制了外部设备接入，修改为允许所有网卡监听：

socket_address = ('0.0.0.0', port)
data_address = ('0.0.0.0', port2)

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