Niri 项目中 Chromium 浏览器输入重复问题的分析与解决

在 Wayland 桌面环境中使用 Niri 窗口管理器时，部分用户报告了 Chromium 浏览器（包括 Chrome 和 Brave 等基于 Chromium 的浏览器）出现输入重复的问题。这个问题特别在使用 fcitx5 输入法框架时表现明显，表现为在某些输入框中按键会被重复输入多次。

问题现象

用户反馈的主要症状包括：

1. 在 Chromium 浏览器的特定输入框中（如过滤器输入框、Bilibili 全屏弹幕输入框等），按键会被重复输入
2. 当打开多个 Chromium 窗口时，重复次数会随着窗口数量增加而增加（如两个窗口时按键重复两次，三个窗口时重复三次）
3. 问题仅在启用 Wayland 原生支持（使用 text-input-v3 协议）时出现，XWayland 模式下正常
4. 其他浏览器如 Firefox 不受影响

技术背景

该问题涉及多个技术层面的交互：

1. Wayland 输入协议：text-input-v3 是 Wayland 的现代输入协议，用于处理输入法和复杂文本输入
2. Chromium 的 Wayland 支持：Chromium 从 129 版本开始实验性支持 text-input-v3 协议
3. 输入法框架：fcitx5 是 Linux 下流行的输入法框架，支持 Wayland 原生输入

问题根源

经过技术分析，问题的根本原因在于 Niri 使用的 Smithay 库在处理多个 text-input-v3 实例时的逻辑缺陷。当 Chromium 浏览器创建多个输入实例时（如打开多个窗口），Smithay 未能正确管理这些实例，导致按键事件被错误地多次分发。

解决方案

Niri 开发团队在提交 d320833 中修复了这个问题。该修复主要涉及：

1. 改进 Smithay 对多个 text-input-v3 实例的管理
2. 确保按键事件只被分发到正确的输入实例
3. 正确处理输入法的启用/禁用状态切换

验证与影响

修复后验证表明：

1. Chromium 浏览器各窗口输入恢复正常
2. fcitx5 输入法切换功能完整可用
3. 连带修复了 YouTube 全屏播放时空格键重复触发暂停/播放的问题
4. 在 Sway 和 Hyprland 等其他 Wayland 合成器中未发现此问题，确认是 Niri/Smithay 特有的问题

用户建议

对于遇到类似问题的用户：

1. 确保使用最新版本的 Niri（包含上述修复）
2. Chromium 浏览器启动时使用正确的 Wayland 标志
3. 检查输入法框架配置是否正确
4. 注意区分 Wayland 原生和 XWayland 模式下的不同行为

这个案例展示了 Wayland 生态系统中各组件间复杂的交互关系，也体现了开源社区通过协作解决问题的效率。随着 Wayland 的普及，这类输入处理问题将越来越受到重视并得到更好的解决方案。