Python Socket服务端发送昵称重复通知但客户端未接收问题排查求助

核心问题定位 #

• 客户端receive函数未做循环接收：当前代码只执行一次recv操作，拿到--%||NICK||%--指令并发送昵称后，函数就直接退出，不会再监听后续服务端发送的ALREADYONLINE消息。
• 服务端发送消息后立刻断连：TCP套接字存在发送缓冲区，默认启用Nagle算法会攒小包延迟发送，你发完ALREADYONLINE后立刻关闭连接，内核大概率会直接丢弃缓冲区中还未发送的消息，直接返回RST包断连，导致客户端收不到消息。
• 额外隐藏bug：你在昵称重复的分支中调用clients.index(client)获取索引，若新连接的客户端还未加入clients列表，会直接抛出ValueError异常，导致后续断连逻辑执行异常，甚至误删已登录的同昵称用户。

修复方案 #

1. 客户端增加循环接收逻辑 #

给receive函数添加永久循环，只要连接未断开就持续接收消息：

def receive(self):
    while True:
        try:
            message = self.sock.recv(1024).decode('utf-8')
            # 收到空内容说明连接已断开，退出循环
            if not message:
                break

            if message == '--%||NICK||%--':
                print('--%||NICK||%--')
                self.sock.send(settings.get_setting(
                    'nickname').encode('utf-8'))

            elif message == '--%||ALREADYONLINE||%--':
                print('--%||ALREADYONLINE||%--')
                messagebox.showerror(
                    title='Nickname Error', message=f"There is already an user connected with the nickname: \"{settings.get_setting('nickname')}\". \n We've changed your last 4 numbers to allow your connection to the server.")
                self.sock.close()
                break
                
            else:
                print('Message is not nickname')

        except Exception as e:
            print(e)
            break

2. 服务端增加优雅关闭逻辑 #

发送完ALREADYONLINE消息后，先半关闭写通道，等待消息发送完成再关闭连接：

# 先导入依赖
import socket
import time

# 原else分支修改
try:
    client.send('--%||ALREADYONLINE||%--'.encode('utf-8'))
    # 半关闭写通道，告诉客户端所有数据已发送完成
    client.shutdown(socket.SHUT_WR)
    # 等待100ms确保消息发送完成，生产环境可替换为等待客户端ACK的逻辑
    time.sleep(0.1)
except Exception as e:
    print('An error occured sending ALREADYONLINE:')
    print(e)

3. 修复列表索引异常 #

如果新连接的客户端未提前加入clients列表，不要调用clients.index(client)，直接移除当前客户端即可，避免误删已登录的同昵称用户。

可选优化 #

为避免TCP粘包问题，建议给每条消息增加分隔符（比如换行符\n），接收时按分隔符拆分消息，防止多条消息被一次性读取导致匹配失败。

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