iframe on Spaces breaks the scroll inconsistently

问题场景

用户在 Hugging Face Spaces 上通过 iframe 嵌入 Gradio 应用（示例为 perceptual-flow-matching-demo），访问时发现滚动行为不稳定：有时可以正常滚动到页面底部，有时滚动失效，且很难稳定复现。Issue 作者怀疑与 Gradio 的 PR #13563 对滚动逻辑的调整有关。

报错原文

iframe on Spaces breaks the scroll inconsistently

原因分析

可能原因：Gradio 6.22.0 在 iframe 嵌入场景下的滚动处理逻辑存在不稳定性，Issue 作者推测是 PR #13563 对滚动行为做了“过度修正”，导致 iframe 内滚动事件被重复处理或与父页面滚动容器冲突。由于问题无法稳定复现，也可能是时序或浏览器会话上下文相关的偶发问题。

环境排查

• 确认 Gradio 版本是否为 6.22.0（Issue 中报告的版本）。
• 确认问题只在 iframe 嵌入时出现，直接打开 Space 页面是否正常。
• 复现时记录浏览器类型、页面会话和操作步骤，便于判断是否为偶现。
• 检查外层页面 iframe 的 CSS（如 height、overflow）是否影响内部滚动。

解决步骤

1. 升级 Gradio 到包含 PR #13695 修复的版本；由于 Issue 未给出具体版本号，可在官方仓库或发布日志中确认该 PR 的合并版本。
2. 如果暂时无法升级，可优先尝试在访问 Space 时使用直接链接而不是 iframe 嵌入，确认滚动是否恢复正常。
3. 若必须使用 iframe，检查 iframe 外层容器是否有限制高度或触发 overflow 的属性，避免父页面参与滚动冲突。
4. 多次刷新或重新进入页面，尝试连续滚动到底部，记录无法复现的具体条件，作为后续反馈依据。

验证方法

在 iframe 嵌入的 Space 页面中反复滚动到页面底部，确认每次都能顺畅到达底部，不再出现“有时可以、有时不行”的不一致现象。建议在不同会话和多次操作中验证，避免偶发复现干扰判断。

参考来源

gradio-app/gradio #13707

AI 工具推荐

想把多个 AI 模型放在一个入口？

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。