转换的时候提示Async task failed错误

[19774279]

pdf文档在官网的线上测试过，转换没有问题。本地转换的时候python 3.10和python3.12都试了，报错一样：

(/data/zsj/conda_envs/mineru_env) root@large-model:/data/zsj/mineru# mineru -p ./2.pdf -o 2-out.pdf
2026-03-31 17:36:16.542 | INFO     | mineru.cli.client:run_orchestrated_cli:874 - Started local mineru-api at http://127.0.0.1:47429
2026-03-31 17:36:19.811 | INFO     | __main__:create_app:243 - Request concurrency limited to 3
Start MinerU FastAPI Service: http://127.0.0.1:47429
API documentation: http://127.0.0.1:47429/docs
INFO:     Started server process [3069279]
INFO:     Waiting for application startup.
INFO:     Application startup complete.
INFO:     Uvicorn running on http://127.0.0.1:47429 (Press CTRL+C to quit)
2026-03-31 17:36:20.572 | INFO     | mineru.cli.client:run_planned_task:771 - Submitting batch 1/1 | 1 document, 1 page in this batch | 1 page total | task#1 [2]
2026-03-31 17:36:23.251 | INFO     | mineru.utils.engine_utils:get_vlm_engine:34 - Using vllm-async-engine as the inference engine for VLM.
Downloading Model from https://www.modelscope.cn to directory: /root/.cache/modelscope/hub/models/OpenDataLab/MinerU2.5-2509-1.2B
2026-03-31 17:36:25,591 - modelscope - INFO - Target directory already exists, skipping creation.
2026-03-31 17:36:26.944 | ERROR    | __main__:_process_task:1212 - Async task failed: 63492a24-473e-4937-b762-29a7f0aea2a8
Traceback (most recent call last):

  File "/data/zsj/conda_envs/mineru_env/lib/python3.10/site-packages/mineru/backend/vlm/vlm_analyze.py", line 144, in get_model
    from vllm.v1.engine.async_llm import AsyncLLM
  File "/data/zsj/conda_envs/mineru_env/lib/python3.10/site-packages/vllm/v1/engine/async_llm.py", line 17, in <module>
    from vllm.engine.protocol import EngineClient
  File "/data/zsj/conda_envs/mineru_env/lib/python3.10/site-packages/vllm/engine/protocol.py", line 20, in <module>
    from vllm.v1.engine.processor import Processor
  File "/data/zsj/conda_envs/mineru_env/lib/python3.10/site-packages/vllm/v1/engine/processor.py", line 26, in <module>
    from vllm.v1.structured_output.backend_guidance import validate_guidance_grammar
  File "/data/zsj/conda_envs/mineru_env/lib/python3.10/site-packages/vllm/v1/structured_output/__init__.py", line 17, in <module>
    from vllm.v1.structured_output.backend_xgrammar import XgrammarBackend
  File "/data/zsj/conda_envs/mineru_env/lib/python3.10/site-packages/vllm/v1/structured_output/backend_xgrammar.py", line 20, in <module>
    from vllm.v1.structured_output.utils import (
         │    └ <module 'vllm.v1' from '/data/zsj/conda_envs/mineru_env/lib/python3.10/site-packages/vllm/v1/__init__.py'>
         └ <module 'vllm' from '/data/zsj/conda_envs/mineru_env/lib/python3.10/site-packages/vllm/__init__.py'>
  File "/data/zsj/conda_envs/mineru_env/lib/python3.10/site-packages/vllm/v1/structured_output/utils.py", line 14, in <module>
    from diskcache import Cache
  File "/data/zsj/conda_envs/mineru_env/lib/python3.10/site-packages/diskcache/__init__.py", line 8, in <module>
    from .core import (
  File "/data/zsj/conda_envs/mineru_env/lib/python3.10/site-packages/diskcache/core.py", line 14, in <module>
    import sqlite3
  File "/data/zsj/conda_envs/mineru_env/lib/python3.10/sqlite3/__init__.py", line 57, in <module>
    from sqlite3.dbapi2 import *
  File "/data/zsj/conda_envs/mineru_env/lib/python3.10/sqlite3/dbapi2.py", line 27, in <module>
    from _sqlite3 import *

ImportError: /lib/x86_64-linux-gnu/libstdc++.so.6: version `CXXABI_1.3.15' not found (required by /data/zsj/conda_envs/mineru_env/lib/python3.10/lib-dynload/../.././libicui18n.so.78)


During handling of the above exception, another exception occurred:


Traceback (most recent call last):

  File "/data/zsj/conda_envs/mineru_env/lib/python3.10/runpy.py", line 196, in _run_module_as_main
    return _run_code(code, main_globals, None,
           │         │     └ {'__name__': '__main__', '__doc__': None, '__package__': 'mineru.cli', '__loader__': <_frozen_importlib_external.SourceFileLo...
           │         └ <code object <module> at 0x7f87201a2080, file "/data/zsj/conda_envs/mineru_env/lib/python3.10/site-packages/mineru/cli/fast_a...
           └ <function _run_code at 0x7f872032f6d0>
  File "/data/zsj/conda_envs/mineru_env/lib/python3.10/runpy.py", line 86, in _run_code
    exec(code, run_globals)
         │     └ {'__name__': '__main__', '__doc__': None, '__package__': 'mineru.cli', '__loader__': <_frozen_importlib_external.SourceFileLo...
         └ <code object <module> at 0x7f87201a2080, file "/data/zsj/conda_envs/mineru_env/lib/python3.10/site-packages/mineru/cli/fast_a...
  File "/data/zsj/conda_envs/mineru_env/lib/python3.10/site-packages/mineru/cli/fast_api.py", line 1500, in <module>
    main()
    └ <Command main>
  File "/data/zsj/conda_envs/mineru_env/lib/python3.10/site-packages/click/core.py", line 1485, in __call__
    return self.main(*args, **kwargs)
           │    │     │       └ {}
           │    │     └ ()
           │    └ <function Command.main at 0x7f871f43f490>
           └ <Command main>
  File "/data/zsj/conda_envs/mineru_env/lib/python3.10/site-packages/click/core.py", line 1406, in main
    rv = self.invoke(ctx)
         │    │      └ <click.core.Context object at 0x7f8417c00820>
         │    └ <function Command.invoke at 0x7f871f43f370>
         └ <Command main>
  File "/data/zsj/conda_envs/mineru_env/lib/python3.10/site-packages/click/core.py", line 1269, in invoke
    return ctx.invoke(self.callback, **ctx.params)
           │   │      │    │           │   └ {'host': '127.0.0.1', 'port': 47429, 'reload': False, 'enable_vlm_preload': False}
           │   │      │    │           └ <click.core.Context object at 0x7f8417c00820>
           │   │      │    └ <function main at 0x7f8417b22560>
           │   │      └ <Command main>
           │   └ <function Context.invoke at 0x7f871f43e710>
           └ <click.core.Context object at 0x7f8417c00820>
  File "/data/zsj/conda_envs/mineru_env/lib/python3.10/site-packages/click/core.py", line 824, in invoke
    return callback(*args, **kwargs)
           │         │       └ {'host': '127.0.0.1', 'port': 47429, 'reload': False, 'enable_vlm_preload': False}
           │         └ ()
           └ <function main at 0x7f8417b22560>
  File "/data/zsj/conda_envs/mineru_env/lib/python3.10/site-packages/click/decorators.py", line 34, in new_func
    return f(get_current_context(), *args, **kwargs)
           │ │                       │       └ {'host': '127.0.0.1', 'port': 47429, 'reload': False, 'enable_vlm_preload': False}
           │ │                       └ ()
           │ └ <function get_current_context at 0x7f871f3dd3f0>
           └ <function main at 0x7f8417b227a0>
  File "/data/zsj/conda_envs/mineru_env/lib/python3.10/site-packages/mineru/cli/fast_api.py", line 1496, in main
    server.run()
    │      └ <function Server.run at 0x7f871f2f5000>
    └ <uvicorn.server.Server object at 0x7f8417b41750>
  File "/data/zsj/conda_envs/mineru_env/lib/python3.10/site-packages/uvicorn/server.py", line 75, in run
    return asyncio_run(self.serve(sockets=sockets), loop_factory=self.config.get_loop_factory())
           │           │    │             │                      │    │      └ <function Config.get_loop_factory at 0x7f871f274310>
           │           │    │             │                      │    └ <uvicorn.config.Config object at 0x7f8417c00490>
           │           │    │             │                      └ <uvicorn.server.Server object at 0x7f8417b41750>
           │           │    │             └ None
           │           │    └ <function Server.serve at 0x7f871f2f5090>
           │           └ <uvicorn.server.Server object at 0x7f8417b41750>
           └ <function asyncio_run at 0x7f871f493a30>
  File "/data/zsj/conda_envs/mineru_env/lib/python3.10/site-packages/uvicorn/_compat.py", line 60, in asyncio_run
    return loop.run_until_complete(main)
           │    │                  └ <coroutine object Server.serve at 0x7f8417b04a50>
           │    └ <cyfunction Loop.run_until_complete at 0x7f8417c7de40>
           └ <uvloop.Loop running=True closed=False debug=False>
> File "/data/zsj/conda_envs/mineru_env/lib/python3.10/site-packages/mineru/cli/fast_api.py", line 1202, in _process_task
    await self._run_task(task)
          │    │         └ AsyncParseTask(task_id='63492a24-473e-4937-b762-29a7f0aea2a8', status='failed', backend='hybrid-auto-engine', file_names=['2'...
          │    └ <function AsyncTaskManager._run_task at 0x7f8417bfecb0>
          └ <__main__.AsyncTaskManager object at 0x7f84170575b0>
  File "/data/zsj/conda_envs/mineru_env/lib/python3.10/site-packages/mineru/cli/fast_api.py", line 1232, in _run_task
    await run_parse_job(
          └ <function run_parse_job at 0x7f8417bfe170>
  File "/data/zsj/conda_envs/mineru_env/lib/python3.10/site-packages/mineru/cli/fast_api.py", line 927, in run_parse_job
    await aio_do_parse(**parse_kwargs)
          │              └ {'output_dir': '/tmp/mineru-api-client-wv73j_93/output/63492a24-473e-4937-b762-29a7f0aea2a8', 'pdf_file_names': ['2'], 'pdf_b...
          └ <function aio_do_parse at 0x7f8417bf3640>
  File "/data/zsj/conda_envs/mineru_env/lib/python3.10/site-packages/mineru/cli/common.py", line 789, in aio_do_parse
    await _async_process_hybrid(
          └ <function _async_process_hybrid at 0x7f8417bf3490>
  File "/data/zsj/conda_envs/mineru_env/lib/python3.10/site-packages/mineru/cli/common.py", line 543, in _async_process_hybrid
    middle_json, infer_result, _vlm_ocr_enable = await aio_hybrid_doc_analyze(
                                                       └ <function aio_doc_analyze at 0x7f839b6765f0>
  File "/data/zsj/conda_envs/mineru_env/lib/python3.10/site-packages/mineru/backend/hybrid/hybrid_analyze.py", line 681, in aio_doc_analyze
    predictor = ModelSingleton().get_model(backend, model_path, server_url, **kwargs)
                │                          │        │           │             └ {}
                │                          │        │           └ None
                │                          │        └ None
                │                          └ 'vllm-async-engine'
                └ <class 'mineru.backend.vlm.vlm_analyze.ModelSingleton'>
  File "/data/zsj/conda_envs/mineru_env/lib/python3.10/site-packages/mineru/backend/vlm/vlm_analyze.py", line 147, in get_model
    raise ImportError("Please install vllm to use the vllm-async-engine backend.")

ImportError: Please install vllm to use the vllm-async-engine backend.
INFO:     Shutting down
INFO:     Waiting for application shutdown.
INFO:     Application shutdown complete.
INFO:     Finished server process [3069279]
Error: 1 task(s) failed while processing documents:
- task#1 (2): Task 63492a24-473e-4937-b762-29a7f0aea2a8 failed for task#1 [2]: {"task_id": "63492a24-473e-4937-b762-29a7f0aea2a8", "status": "failed", "backend": "hybrid-auto-engine", "file_names": ["2"], "created_at": "2026-03-31T09:36:20.660152+00:00", "started_at": "2026-03-31T09:36:20.660736+00:00", "completed_at": "2026-03-31T09:36:26.943969+00:00", "error": "Please install vllm to use the vllm-async-engine backend.", "status_url": "http://127.0.0.1:47429/tasks/63492a24-473e-4937-b762-29a7f0aea2a8", "result_url": "http://127.0.0.1:47429/tasks/63492a24-473e-4937-b762-29a7f0aea2a8/result", "queued_ahead": 0}
(/data/zsj/conda_envs/mineru_env) root@large-model:/data/zsj/mineru# 

[myhloli]

没有安装vllm吗

[dosubot[bot]]

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

你的错误有两层原因：

1. 根本原因：系统的 libstdc++.so.6 版本太旧，缺少 CXXABI_1.3.15 符号（这个符号需要 GCC 12+ 提供的 libstdc++）。这导致 sqlite3 → vllm 整个导入链失败。
2. 表面错误：因为 vllm 导入失败，MinerU 抛出 ImportError: Please install vllm to use the vllm-async-engine backend.

有几个解决方案，按推荐顺序：

方案一：使用 pipeline 后端跳过 vllm（最快的解决方式）[1]

mineru -p ./2.pdf -o 2-out.pdf --backend pipeline

pipeline 后端不依赖 vllm，兼容性更好，也支持 CPU 运行 [2]。

方案二：升级系统 libstdc++
如果你是 Ubuntu 系统，可以安装更新的 GCC 工具链：

sudo apt update
sudo apt install gcc-12 g++-12 libstdc++6

或者在 conda 环境中安装：

conda install -c conda-forge libstdcxx-ng

方案三：使用官方 Docker 镜像
Docker 镜像中所有 C++ 依赖已经预配置好，不会有 ABI 不兼容问题 [3]。

另外，如果你确实需要使用 vllm 后端，确保安装方式正确 [4]：

pip install "mineru[core,vllm]"

并且注意 vllm 版本需要 >=0.10.1.1, <0.12，配合 PyTorch >=2.6.0 [5]。

To reply, just mention @dosu.

---

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

   

[19774279]

升级了 libstdc++确实好了，升级以后自动安装了vllm