自行构建mineru镜像并启动gradio一直白屏

[ZenCoderWu]

🔎 Search before asking | 提交之前请先搜索

• I have searched the MinerU Readme and found no similar bug report.
• I have searched the MinerU Issues and found no similar bug report.
• I have searched the MinerU Discussions and found no similar bug report.

🤖 Consult the online AI assistant for assistance | 在线 AI 助手咨询

• I have consulted the online AI assistant but was unable to obtain a solution to the issue.

Description of the bug | 错误描述

今天自己构建了个镜像，然后使用官方compose.yaml 启动 mineru-gradio服务，打开网页一直白屏。
console 日志：

错误代码行：

查看gradio仓库，今天发布了5.38.1的版本中，有如下commit：
gradio@5.38.1

Commit 801f288：

应该是此次修改导致的。

How to reproduce the bug | 如何复现

构建镜像，启动mineru-gradio，并访问8760。

Operating System Mode | 操作系统类型

Linux

Operating System Version| 操作系统版本

Ubuntu 22.04

Python version | Python 版本

3.10

Software version | 软件版本 (mineru --version)

2.0.x

Device mode | 设备模式

cuda

[dosubot]

Hi @githubwyj! I'm Dosu and I’m helping the MinerU team.

你的问题确实和 Gradio 5.38.1 的更新有关。MinerU 的依赖（pyproject.toml）只限定了 gradio>=5.34,<6，没有锁定小版本，所以你每次构建镜像时都会自动拉取最新的 Gradio 5.x 版本。如果 Gradio 新版本有不兼容的变更（比如 5.38.1 的 i18n 逻辑变动），就会导致前端白屏和 Svelte i18n 报错（如“Cannot format a message without first setting the initial locale.”）相关讨论。

解决方法：在 Dockerfile 或容器内强制安装一个已知可用的 Gradio 版本（如 5.37.0）。比如在 Dockerfile 里加一行：

RUN pip install gradio==5.37.0

或者进入容器后执行：

pip install gradio==5.37.0

这样可以避免新版本带来的不兼容问题。社区里有用户反馈降级到 5.37.0 后白屏问题消失，WebUI 正常显示案例。

建议后续官方锁定 Gradio 小版本，避免类似问题反复出现。

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}    

[ZenCoderWu]

Hi @githubwyj! I'm Dosu and I’m helping the MinerU team.

你的问题确实和 Gradio 5.38.1 的更新有关。MinerU 的依赖（pyproject.toml）只限定了 gradio>=5.34,<6，没有锁定小版本，所以你每次构建镜像时都会自动拉取最新的 Gradio 5.x 版本。如果 Gradio 新版本有不兼容的变更（比如 5.38.1 的 i18n 逻辑变动），就会导致前端白屏和 Svelte i18n 报错（如“Cannot format a message without first setting the initial locale.”）相关讨论。

解决方法：在 Dockerfile 或容器内强制安装一个已知可用的 Gradio 版本（如 5.37.0）。比如在 Dockerfile 里加一行：

RUN pip install gradio==5.37.0
或者进入容器后执行：

pip install gradio==5.37.0
这样可以避免新版本带来的不兼容问题。社区里有用户反馈降级到 5.37.0 后白屏问题消失，WebUI 正常显示案例。

建议后续官方锁定 Gradio 小版本，避免类似问题反复出现。

To reply, just mention @dosu.

How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other    

嗯，已自行安装gradio==5.38.0，可以正常访问。

[yujianfeikong]

我也遇到了同样的问题
pip install gradio==5.38.0
容器内安装5.38后正常了

[myhloli]

gradio-app/gradio#11554

[GallonDeng]

本地一键安装部署，可以试试https://learn2ask.net/, 搜索mineru，避免环境问题，轻松解决

[myhloli]

gradio更新了5.38.2，已修复该问题