快速结论:在 Open WebUI dev 分支中,打开菜单后再动态出现在列表里的条目(如刚上传的文件、后添加的标签),用方向键、Home、End 无法聚焦,焦点只停留在菜单打开那一刻已存在的条目上;优先排查菜单键盘导航逻辑是否在渲染时缓存了初始条目集合。
适用环境:Open WebUI dev 分支,自提交 1de86d8d1(PR #33359)起出现;Issue 未提供具体的操作系统、浏览器、Python 或依赖版本信息。
最快修复方案:暂无确认的一步修复方案。该问题被判定为已引入的键盘导航回归,可从两个方向处理:回退到 1de86d8d1(#33359)之前的 dev 版本作为临时规避,或等待包含修复的新版本。
注意事项:回退提交只是绕过方案,会同时失去 #33359 引入的其他改动,且需自行确认版本兼容性。Issue 未说明具体修复提交或修复版本,升级前请先确认目标版本已包含对应修复。
问题场景
在 Open WebUI dev 构建中,使用键盘操作各类弹出菜单时触发。典型复现路径:上传两个文件后打开消息框的 More(+)菜单并选择 Attach Files,将焦点移到 “Files” 行后连续按向下方向键;或给聊天添加标签后打开该聊天的操作菜单(顶部 “…”),从 Share 开始连续按向下方向键。相同现象还出现在 Attach Knowledge、Attach Notes、Reference Chats 列表、自动化文件夹搜索结果、频道表情选择器、手机端 Back 行以及搜索对话框的内容类型列表中。鼠标点击与 Tab 键仍可到达这些新增条目。
报错原文
issue: [dev] arrow keys skip menu entries that appear after the menu opens
Menus let the arrow keys, Home and End move only between the entries that were there the moment the menu opened. Entries that show up afterwards are skipped. They can still be reached with Tab or the mouse.
Actual
Focus stays on "Files". In the chat actions menu it cycles Share to Delete and never reaches the tag.
Version
dev only, since 1de86d8d1 (#33359).
原因分析
可能原因:1de86d8d1(#33359)对下拉/菜单组件的按键导航实现做了改动后,方向键、Home、End 的遍历范围在菜单打开时即被确定,只覆盖当时已渲染的菜单项,未随后续动态插入的条目刷新。因此上传文件、添加标签、加载搜索结果等异步或延迟渲染产生的菜单项不会被方向键遍历到,但 Tab 键与鼠标走的是浏览器原生焦点与事件路径,不受影响。相关 Issue(#33358、#32939、#33106)报告了同一菜单键盘导航区域的回归,指向相同的底层实现。
环境排查
- 确认 Open WebUI 是否为 dev 分支,且提交时间晚于 1de86d8d1(#33359)。
- 确认现象是否只在菜单打开后才新增的条目上出现,而菜单打开时已存在的条目方向键正常。
- 确认同一菜单中用 Tab 或鼠标能否到达被跳过的条目,以排除条目本身渲染失败。
- 分别在消息框菜单、聊天操作菜单、搜索对话框内容类型列表等至少两个入口复现,判断是否属于同一问题。
- 浏览器版本、操作系统、Python 与依赖版本在 Issue 中未给出,排查时建议一并记录,便于对比上游修复。
解决步骤
- 先按 Issue 的复现步骤确认真实复现:打开菜单后通过操作使新条目(如上传文件、添加标签)出现,再按向下方向键观察焦点是否停留在原条目上。
- 如需立即恢复可用性,回退到 1de86d8d1(#33359)之前的 dev 版本,并重新验证菜单方向键行为。
- 回退期间可临时使用 Tab 键或鼠标访问动态出现的菜单条目,作为功能规避。
- 关注上游对该菜单导航回归的修复,#33358 被列为最接近的关联 Issue,可跟踪其进展与修复提交。
- 升级到包含修复的版本后,按原复现步骤做一次回归确认。Issue 未给出具体修复版本,此步骤的可优先尝试前提是版本说明中已包含相应修复。
验证方法
重新执行 Issue 中的两条复现路径:在 Attach Files 菜单的 “Files” 行连续按向下方向键,焦点应能移动到已上传的文件条目;在聊天操作菜单中从 Share 向下按,焦点应能经过 Delete 到达后添加的标签。另外抽查 Attach Knowledge、Attach Notes、Reference Chats、搜索结果、表情选择器和搜索对话框内容类型列表,确认新出现的条目可通过方向键、Home、End 到达。
参考来源
open-webui/open-webui #33358(关联 Issue,最接近的同类菜单键盘导航回归)
open-webui/open-webui #32939(关联 Issue,消息框菜单方向键导航)
open-webui/open-webui #33106(关联 Issue,用户菜单与聊天菜单方向键导航)
AI 工具推荐
想把多个 AI 模型放在一个入口?
GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。
推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。
这个方案解决了吗?
可以继续搜索完整报错,或查看同一工具的其他排查指南。


