客户端连不上服务端主因是服务端未成功监听，需确认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 阻塞。
多个客户端连接后，只有第一个能收发消息
核心问题在于服务端没为每个连接启动独立线程处理通信，而是串行处理：一个客户端连上、读、写、断开后才接受下一个——这根本不是“聊天室”，只是单聊模拟器。
Java注释规范Skills
下载
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
- 必须在
accept()返回Socket后立刻丢进新线程：new Thread(() -> handleClient(clientSocket)).start();
-
handleClient()方法里要封装完整的读写循环，不能只读一次就退出； - 共享资源（如存储在线用户列表的
ArrayList<PrintWriter>）必须加同步：用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()，或捕获异常后从列表中移除失效对象——这点初学者几乎都会漏掉。
