x

docker/README.md

@@ -428,16 +428,17 @@ PY'
 
 当前入口脚本会在服务启动前执行同样的 vLLM 导入验证；如果验证失败，容器会直接退出并在 `docker compose logs gradio` 中显示真实 traceback，而不是等任务执行时才报泛化错误。
 
-如果日志明确显示 `ModuleNotFoundError: No module named 'vllm'`，说明 MinerU 依赖安装后 editable vLLM 没有注册到虚拟环境。当前 Dockerfile 已在安装 MinerU 后重新执行：
+如果日志明确显示 `ModuleNotFoundError: No module named 'vllm'`，常见原因是 vLLM 分发元数据不可见，但 `/opt/vllm` 源码仍在。当前镜像已通过 `PYTHONPATH=/opt/vllm` 和入口脚本兜底保证可导入，避免 editable 安装触发 `pyproject.toml` 元数据校验失败。
 
 ```bash
-cd /opt/vllm && /opt/mineru_venv/bin/pip install -e . --no-build-isolation --no-deps
+export PYTHONPATH=/opt/vllm:${PYTHONPATH}
+/opt/mineru_venv/bin/python -c "import vllm; print(vllm.__version__)"
 ```
 
 入口脚本也会在启动时自动尝试这个修复。你也可以在旧容器里手动验证/修复一次：
 
 ```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 exec gradio bash -lc 'export PYTHONPATH=/opt/vllm:${PYTHONPATH}; /opt/mineru_venv/bin/python -c "import vllm; print(vllm.__version__)"'
 docker compose restart gradio
 ```