客户端连不上服务端主因是服务端未成功监听,需确认serverSocket.accept()前已启动、防火墙未拦截、端口未被占用、绑定地址用默认0.0.0.0;readLine阻塞因缺换行符,须发送时加"\n"或用PrintWriter.println;多客户端需为每个连接启新线程并同步共享资源;关闭连接须按输出流→输入流→socket顺序,推荐try-with-resources;广播前应检查PrintWriter有效性以防异常。

Java Socket 编程中客户端连不上服务端的常见原因
绝大多数初学者卡在“启动服务端后,客户端 new Socket("127.0.0.1", 8080) 直接抛 java.net.ConnectException: Connection refused”,根本不是代码写错,而是服务端压根没真正监听成功。
- 检查服务端是否真的执行到了
serverSocket.accept()之前那行——加一句System.out.println("Server started on port 8080")确认; - 确认没在防火墙/杀毒软件拦截下运行(尤其 Windows);
- 避免端口被占用:
netstat -ano | findstr :8080(Windows)或lsof -i :8080(macOS/Linux),杀掉残留进程; - 服务端绑定地址别写死成
new ServerSocket(8080, 50, InetAddress.getByName("192.168.1.100")),初学一律用无参构造或new ServerSocket(8080),它默认监听0.0.0.0,能响应所有本地 IP。
用 BufferedReader.readLine() 读取消息时程序卡住不动
这是阻塞 I/O 的典型表现:客户端或服务端调用 readLine() 后线程挂起,等不到换行符就不返回。根本原因是发送方没发 "\n" 或 "\r\n"。
- 发送消息必须显式加换行:
outputStream.writeBytes(message + "\n")或更稳妥地用PrintWriter.println(message)(它自动加平台换行); - 别混用流:如果用
PrintWriter发送,就别用BufferedReader以外的读取方式;Scanner.nextLine()在 socket 场景下容易因缓冲区问题出错,不推荐; - 注意字符编码:双方都显式指定 UTF-8,比如
new OutputStreamWriter(outputStream, "UTF-8"),否则中文可能乱码或截断导致 readLine 阻塞。
多个客户端连接后,只有第一个能收发消息
核心问题在于服务端没为每个连接启动独立线程处理通信,而是串行处理:一个客户端连上、读、写、断开后才接受下一个——这根本不是“聊天室”,只是单聊模拟器。
- 必须在
accept()返回Socket后立刻丢进新线程:new Thread(() -> handleClient(clientSocket)).start();
-
handleClient()方法里要封装完整的读写循环,不能只读一次就退出; - 共享资源(如存储在线用户列表的
ArrayList)必须加同步:用Collections.synchronizedList(new ArrayList()),或在遍历时用synchronized(list)块包裹; - 别在主线程里直接操作 UI(比如 Swing 的 JTextArea),转发到事件调度线程:
SwingUtilities.invokeLater(() -> textArea.append(...))。
关闭连接时出现 IOException 或资源泄漏
常见于只关了 Socket 却忘了关其包装流,或流关闭顺序错误导致 IOException: Stream closed。
立即学习“Java免费学习笔记(深入)”;
- 关闭顺序必须是:先关输出流(触发 flush),再关输入流,最后关 socket;
- 用 try-with-resources 最安全:
try (Socket client = serverSocket.accept(); PrintWriter out = new PrintWriter(client.getOutputStream(), true); BufferedReader in = new BufferedReader(new InputStreamReader(client.getInputStream(), "UTF-8"))) { // 处理逻辑 } catch (IOException e) { ... } - 客户端主动断开时,服务端
readLine()会返回null,这是正常终止信号,不是异常,应立即 break 循环并关闭资源; - 别在 finally 块里盲目调用
socket.close()——如果 socket 已经是 null 或已关闭,会抛 NPE 或 IllegalMonitorStateException。
真正麻烦的是消息广播的线程安全和连接状态管理:比如某个客户端断连了,它的 PrintWriter 还留在列表里,后续广播就会触发 IOException。得在每次写前检查 pw.checkError(),或捕获异常后从列表中移除失效对象——这点初学者几乎都会漏掉。










