subprocess异步执行LibreOffice转PDF时重复调用约半数文件失败的修复

你遇到的50%概率转换失败、伴随输出javaldx: 无法找到Java Runtime Environment的问题，核心不是真的缺失JVM或libreoffice-java-common包，是两个实现漏洞叠加导致的：

• LibreOffice headless模式有硬性限制：同一个UserInstallation配置路径同一时间只能运行1个实例。你现有代码的配置路径只拼了author字段，只要同一用户触发并发转换、或上一个同用户的转换进程没完全退出，新进程就会因为配置目录锁、端口冲突直接启动失败。
• 当LibreOffice实例启动异常、或配置目录残留损坏的javasettings_Linux_*.xml文件时，javaldx模块会因为初始化流程中断抛出Java相关的错误提示，属于实例启动失败的连带输出，不是转换失败的根本原因。

1. 给每个转换任务分配独立的临时配置目录，彻底解决并发冲突 #

不要只用author作为配置目录的唯一标识，给每次转换叠加随机唯一串（如uuid4、毫秒时间戳），保证每个转换进程的UserInstallation路径完全独立，从根源避免实例抢锁的问题。

旧的易冲突写法参考：
'file:///tmp/LibreOffice_Conversion_' + author
修改为带唯一标识的写法：

import uuid
config_dir = f"file:///tmp/LibreOffice_Conversion_{author}_{uuid.uuid4().hex}"

2. 从根源消除Java相关的告警/报错 #

普通doc/docx转PDF的场景完全不需要Java环境，在soffice启动命令里追加参数强制跳过Java检测、关闭多余的启动流程，就不会再触发javaldx的异常报错：

• 追加-env:JAVA_HOME=/dev/null直接屏蔽Java环境查找逻辑
• 追加--nodefault --nofirststartwizard --nolockcheck --nologo --norestore参数，减少非必要的初始化流程，加快进程退出速度，减少残留锁文件的概率。

3. 优化命令调用方式，避免shell注入和路径解析错误 #

现有代码直接把author、folder、input_file拼接到shell命令里，如果文件路径带空格、或字段包含特殊字符，会直接导致命令解析失败。推荐改用asyncio.create_subprocess_exec直接传参数列表，不需要依赖shell解析，同时避免shell注入风险。

4. 增加退出码校验逻辑 #

现有代码仅判断stderr是否有输出，但LibreOffice转换失败时，stderr往往只会输出Java相关的通用告警，不会明确提示转换失败。必须加上进程退出码判断：只要conversion_process.returncode != 0，就判定为转换失败，不要把告警当报错、也不要把真的失败判定为成功。

5. 自动清理临时配置目录 #

每一次转换流程结束（不管成功或失败），主动删除本次生成的临时UserInstallation目录，避免/tmp目录被占满、残留的锁文件或损坏的Java配置文件影响后续任务。

6. 增加轻量重试机制 #

即使做了上述优化，偶尔还是会遇到系统层面进程残留、临时目录清理不及时的问题，可以给转换流程加最多2-3次的重试，每次重试间隔1-2秒，进一步降低偶发失败率。

import asyncio
import subprocess
import uuid
import shutil
from pathlib import Path

async def convert_doc_to_pdf(author: str, folder: str, input_file: str):
    # 生成当前任务专属的唯一临时配置目录
    config_id = uuid.uuid4().hex
    config_dir_path = Path(f"/tmp/LibreOffice_Conversion_{author}_{config_id}")
    config_dir_url = f"file://{config_dir_path.resolve()}"
    try:
        cmd = [
            "soffice",
            f"-env:UserInstallation={config_dir_url}",
            "-env:JAVA_HOME=/dev/null",
            "--headless",
            "--nodefault",
            "--nofirststartwizard",
            "--nolockcheck",
            "--nologo",
            "--norestore",
            "--convert-to", "pdf",
            "--outdir", folder,
            input_file
        ]
        # 直接传参数列表执行，避免shell解析问题
        conversion_process = await asyncio.create_subprocess_exec(
            *cmd,
            stdout=subprocess.PIPE,
            stderr=subprocess.PIPE
        )
        stdout, stderr = await conversion_process.communicate()
        # 同时校验退出码和输出
        if conversion_process.returncode != 0:
            app.logger.error(f"PDF转换失败，退出码{conversion_process.returncode}，错误输出：{stderr.decode('utf-8', errors='ignore')}")
            return False
        if stderr:
            app.logger.warning(f"转换过程告警：{stderr.decode('utf-8', errors='ignore')}")
        return True
    finally:
        # 无论任务成功失败，都清理本次的临时配置目录
        if config_dir_path.exists():
            shutil.rmtree(config_dir_path, ignore_errors=True)

内容的提问来源于stack exchange，提问作者Vishal Verma