x

docker/README.md

@@ -428,6 +428,19 @@ PY'
 
 当前入口脚本会在服务启动前执行同样的 vLLM 导入验证；如果验证失败，容器会直接退出并在 `docker compose logs gradio` 中显示真实 traceback，而不是等任务执行时才报泛化错误。
 
+如果日志明确显示 `ModuleNotFoundError: No module named 'vllm'`，说明 MinerU 依赖安装后 editable vLLM 没有注册到虚拟环境。当前 Dockerfile 已在安装 MinerU 后重新执行：
+
+```bash
+cd /opt/vllm && /opt/mineru_venv/bin/pip install -e . --no-build-isolation --no-deps
+```
+
+入口脚本也会在启动时自动尝试这个修复。你也可以在旧容器里手动验证/修复一次：
+
+```bash
+docker compose exec gradio bash -lc 'cd /opt/vllm && /opt/mineru_venv/bin/pip install -e . --no-build-isolation --no-deps && /opt/mineru_venv/bin/python -c "import vllm; print(vllm.__version__)"'
+docker compose restart gradio
+```
+
 **Q: 构建时 `ninja` 被 kill（exit 137）**
 
 内存不足。将 Dockerfile 中 `ninja -j4` 改为 `ninja -j2` 或 `ninja -j1`，或给 Docker 分配更多内存。