Python+asyncio+pywinpty实现Telnet客户端时输出乱码问题排查

问题背景 #

我正在开发一个类似精简版Terminado的跨平台控制台应用包装器，支持远程客户端连接并交互子进程的标准输入输出。Windows平台采用pywinpty实现，确保上下箭头历史命令等终端功能正常。

架构设计 #

• 每个新客户端连接对应一个reader任务，负责将客户端输入写入子进程stdin
• writer类监控全局pty输出队列，将队列中的数据转发给所有在线客户端
• pty_reader持续读取pty输出，并将数据存入全局字节队列

遇到的两类Telnet测试问题 #

1. 当前输入的字符会在自身客户端重复显示（其他客户端无此问题），已关闭本地回显，终端类型设为ANSI
2. 偶尔会输出部分异常转义码，例如客户端连接时接收到包含异常转义字符的内容

已尝试无效的方案 #

• 匹配终端行列数（80列24行）
• 修改终端类型（如VT100）

问题1：输入字符本地重复显示 #

根源：pywinpty默认开启了pty自身的本地回显，即便关闭了Telnet客户端的本地回显，pty仍会把输入内容回写至输出队列，导致当前客户端收到两次输入（一次自身发送的原始数据，一次pty的回显数据）。

解决方案：

1. 创建winpty进程时显式禁用回显，在PtyProcess.spawn中添加echo=False参数：

process = PtyProcess.spawn(command, echo=False)

2. 确认Telnet客户端本地回显确实关闭：可在连接后执行mode con echo off（Windows）或通过客户端设置关闭回显，避免因双重关闭导致输入无反馈。

问题2：异常转义码输出 #

根源：终端初始化不匹配，或转义码在多客户端转发时被拆分成不完整片段，导致解析异常。

解决方案：

1. 统一终端初始化流程：新客户端连接时，主动发送标准ANSI初始化序列，覆盖pywinpty默认初始化内容：

# 给新连接客户端发送重置序列：清除格式、清屏、光标归位
client.send(b'\x1b[0m\x1b[2J\x1b[H')

2. 对pty输出做转义码完整性处理，避免拆分转发：在pty_reader中添加转义码缓冲区，确保完整的转义序列才进入全局队列：

escape_buffer = b''
while True:
    data = process.read(1024)
    if not data:
        break
    if escape_buffer:
        escape_buffer += data
        # 简单判断转义序列结束（常见转义码以字母/数字结尾）
        if len(escape_buffer) > 1 and escape_buffer[-1] in b'ABCDEFGHJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789':
            global_queue.put(escape_buffer)
            escape_buffer = b''
        continue
    if b'\x1b' in data:
        parts = data.split(b'\x1b', 1)
        if parts[0]:
            global_queue.put(parts[0])
        escape_buffer = b'\x1b' + parts[1]
    else:
        global_queue.put(data)

3. 强制统一终端环境变量：创建pty时指定TERM=xterm-256color，确保子进程输出标准转义码：

import os
env = os.environ.copy()
env['TERM'] = 'xterm-256color'
process = PtyProcess.spawn(command, env=env, echo=False)

额外验证点 #

• 检查writer类逻辑：确保全局队列的数据仅被所有客户端发送一次，无针对当前客户端的额外回写逻辑
• 换用nc（netcat）替代Telnet测试，排除客户端自身兼容性问题

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