Fonts don’t load correctly on Spaces

用户在使用 Gradio 库(版本 5.29.0)开发应用,通过 gr.Blocks() 构建 WebUI,并在本地 Mac OS 上运行时,部署到 Hugging Face Spaces 后主题字体无法正确加载,浏览器使用回退字体。

Fonts don't load correctly on Spaces

Fonts don’t load correctly on Spaces

快速结论:该报错发生在 Gradio 应用部署到 Hugging Face Spaces 时,主题字体无法正确加载,浏览器回退到默认字体。优先检查 Gradio 版本是否已更新到包含修复的版本。

问题场景

用户在使用 Gradio 库(版本 5.29.0)开发应用,通过 gr.Blocks() 构建 WebUI,并在本地 Mac OS 上运行时,部署到 Hugging Face Spaces 后主题字体无法正确加载,浏览器使用回退字体。

报错原文

Ends up using the browser fallback font instead of the theme font

原因分析

可能原因是 Gradio 在处理字体资源路径时存在漏洞,导致在 Spaces 环境下字体文件无法正确被引用或加载,浏览器因此使用系统默认的回退字体。

环境排查

  • 确认 Gradio 版本:用户报告中使用了 gradio==5.29.0
  • 确认运行环境:Hugging Face Spaces
  • 确认浏览器类型(不同浏览器对字体加载的处理可能不同)

解决步骤

  1. 将 Gradio 版本升级到 5.29.0 之后的版本,该问题已在后续版本中被修复(由 #11504 和 #13463 两个 PR 修复)。
  2. 如果无法升级版本,可优先尝试检查 Spaces 设置中的 Gradio SDK 版本是否匹配。
  3. 如果升级后问题依然存在,可能需要检查自定义主题配置中的字体路径是否正确。

验证方法

升级 Gradio 版本后,重新部署到 Spaces,检查页面字体是否正常显示为主题字体而非回退字体。

参考来源

gradio-app/gradio #11136

celebrityanime
celebrityanime
文章: 12388

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注