TigerVNC在Azure Windows虚拟机中的键盘输入问题分析与解决方案

问题现象

在Azure云环境中，当用户通过Windows 11企业版多会话虚拟机使用TigerVNC Viewer（1.12-1.14版本）连接AlmaLinux 9.1虚拟机时，出现键盘输入异常现象。具体表现为：

1. 普通字母数字键无法输入
2. 控制组合键（如Ctrl+C）可正常识别
3. 鼠标操作、方向键和复制粘贴功能正常
4. 密码输入框不受影响

技术背景分析

该问题涉及多层级输入处理机制：

1. Azure虚拟桌面架构：通过浏览器访问的Windows虚拟机实际上运行在远程桌面协议（RDP）环境中
2. 键盘事件传递链：浏览器→RDP客户端→Windows VM→TigerVNC Viewer→VNC协议→Linux VNC服务器
3. X11输入子系统：Linux端使用GNOME X会话（非Wayland）处理输入事件

根本原因

通过日志分析发现关键错误信息：

Viewport: No scan code for virtual key 0xe7
Viewport: Unexpected release of key code 0

其中0xE7是Windows系统的VK_PACKET虚拟键码，用于传递Unicode字符。这表明：

1. Azure的Web客户端默认使用Unicode键盘输入模式
2. TigerVNC Viewer在非密码输入阶段未能正确处理这种特殊键码转换
3. 不同VNC客户端对键盘布局的处理存在差异（RealVNC/TightVNC表现不同）

解决方案

1. 修改Azure Web客户端设置：

   • 在客户端设置中将键盘布局从"自动选择"改为特定布局（如美式键盘）
   • 必须完全退出并重新登录会话使设置生效

2. 替代方案：

   • 使用RealVNC Viewer（对键盘布局兼容性更好）
   • 如需使用TightVNC Viewer，避免全屏模式

技术启示

1. 云环境中的嵌套远程访问会引入额外的输入处理层级
2. 虚拟键码转换在不同协议层之间可能出现兼容性问题
3. 密码输入阶段与应用阶段的键盘处理机制存在差异（前者通常使用简单扫描码）
4. 全屏模式可能改变应用的输入处理方式

最佳实践建议

1. 在云VDI环境中测试多种VNC客户端
2. 明确设置键盘布局而非依赖自动检测
3. 关键系统维护时准备备用访问方案
4. 复杂环境建议记录完整的输入事件日志（包括客户端和服务器端）