Android Socket客户端卡在‘waiting for message from server.’问题求助

背景说明 #

我开发了一款可对接公司服务器的条码扫描应用，该应用功能运行正常，但我缺乏与服务器建立Socket连接的经验。为避免改动条码扫描应用的原有代码，我参考Socket连接教程编写并修改了测试代码，计划在测试代码成功实现连接并完成数据交互后，将其集成到条码扫描应用中。

问题现象 #

当我点击“连接到服务器”按钮时，日志输出如下：

03-23 11:55:52.174 6438-6459/com.example.vipin.client I/Client: Waiting for message from server...

测试代码（已隐去敏感信息） #

package com.example.vipin.client;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.util.Log;
import android.view.View;
import android.widget.TextView;
import java.io.BufferedReader;
import java.io.BufferedWriter;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.OutputStreamWriter;
import java.io.PrintWriter;
import java.net.InetAddress;
import java.net.Socket;
import java.net.UnknownHostException;
import java.text.SimpleDateFormat;
import java.util.Date;
public class Client extends AppCompatActivity implements View.OnClickListener {
    public static final String TAG = Client.class.getSimpleName();
    public static final int SERVERPORT = 0000;
    public static final String SERVER_IP = "000.000.0.0";
    ClientThread clientThread;
    // 代码存在截断，以下为现有可见部分
}

可能的原因及排查修复步骤 #

从你的日志和代码片段来看，客户端已经进入等待服务器消息的阻塞状态，大概率是连接后数据交互环节出现了问题，以下是具体的排查方向：

1. 先确认服务器端的运行状态 #

• 用telnet 你的服务器IP 端口号命令测试端口是否开放（在电脑终端执行），如果连接失败，说明服务器未正常监听端口，或者存在防火墙/公司网络策略拦截了连接请求。
• 检查服务器端代码：确认服务器在接收到客户端连接后，会主动发送初始响应消息，或者明确要求客户端先发送数据再响应。如果服务器端一直等待客户端发消息，而客户端也在等服务器消息，就会陷入双向阻塞。

2. 补充客户端代码的关键逻辑 #

从截断的代码来看，你需要完善ClientThread中的核心逻辑：

• 设置Socket超时时间：避免readLine()无限阻塞，添加超时后可以捕获异常并排查问题：

  socket.setSoTimeout(10000); // 设置10秒超时，超时会抛出SocketTimeoutException
  

• 主动发送测试数据：如果服务器需要客户端先发起请求，连接成功后立即发送一条测试消息：

  PrintWriter out = new PrintWriter(new BufferedWriter(new OutputStreamWriter(socket.getOutputStream())), true);
  out.println("Client connection test"); // 发送测试消息触发服务器响应
  

• 完善异常捕获日志：在Socket操作的try-catch中添加详细的异常日志，方便定位问题：

  try {
      Socket socket = new Socket(SERVER_IP, SERVERPORT);
      Log.i(TAG, "Successfully connected to server!");
      // 发送测试数据
      PrintWriter out = new PrintWriter(new BufferedWriter(new OutputStreamWriter(socket.getOutputStream())), true);
      out.println("Hello Server");
      // 读取服务器响应
      BufferedReader in = new BufferedReader(new InputStreamReader(socket.getInputStream()));
      String response = in.readLine();
      if (response != null) {
          Log.i(TAG, "Received server message: " + response);
      } else {
          Log.i(TAG, "Server closed the connection unexpectedly");
      }
  } catch (UnknownHostException e) {
      Log.e(TAG, "Failed to resolve server IP: " + e.getMessage());
  } catch (SocketTimeoutException e) {
      Log.e(TAG, "Wait for server response timeout: " + e.getMessage());
  } catch (IOException e) {
      Log.e(TAG, "Socket IO error: " + e.getMessage());
  }
  

3. 检查Android端的网络配置 #

• 确认AndroidManifest.xml中添加了网络权限：

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

• 针对Android 9及以上版本，默认禁止明文传输，需要在<application>标签中添加允许明文流量的配置：

  android:usesCleartextTraffic="true"
  

4. 验证IP和端口的正确性 #

再次确认SERVER_IP是服务器的可达IP（局域网IP或公网IP），SERVERPORT与服务器监听的端口完全一致，且端口未被其他服务占用。

调试小技巧 #

• 用抓包工具（如Wireshark）监控客户端与服务器之间的网络数据包，确认连接是否成功建立、数据是否正常发送/接收。
• 在服务器端也添加详细日志，记录客户端连接请求、数据接收和响应的过程，从两端同时排查问题。

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