Java初学者项目实战:构建简单的聊天室应用

客户端连不上服务端主因是服务端未成功监听,需确认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.synchronizedL

    ist(new ArrayList())
    ,或在遍历时用 synchronized(list) 块包裹;
  • 别在主线程里直接操作 UI(比如 Swing 的 JTextArea),转发到事件调度线程:SwingUtilities.invokeLater(() -> textArea.append(...))

关闭连接时出现 IOException 或资源泄漏

常见于只关了 Socket 却忘了关其包装流,或流关闭顺序错误导致 IOException: Stream closed

  • 关闭顺序必须是:先关输出流(触发 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(),或捕获异常后从列表中移除失效对象——这点初学者几乎都会漏掉。