如何修复自定义Docker容器中doc2pdf找不到uno模块的报错

报错核心是Python环境与LibreOffice的pyuno绑定路径不匹配：

• python:3.9-slim-bullseye镜像内的Python为独立编译版本，默认模块搜索路径不包含Debian系统包安装的第三方库路径
• 通过pip安装的uno==0.3.3是同名第三方工具，和LibreOffice提供的UNO接口绑定完全无关，无法解决依赖问题
• 单独安装python3-uno后，模块实际存放在系统Python的dist-packages路径下，镜像内默认的Python解释器无法扫描到该路径，因此提示找不到uno模块

• 清理无效依赖：从requirements.txt中删除uno==0.3.3、base==1.0.4、unotools三个无关包，避免干扰模块加载。
• 补全系统依赖：安装LibreOffice完整核心组件、官方pyuno绑定，建议同步安装开源中文字体避免中文文档转换乱码。
• 配置模块搜索路径：将系统pyuno模块所在路径加入PYTHONPATH环境变量，让镜像内的Python解释器可以正常加载uno模块。

FROM python:3.9-slim-bullseye
WORKDIR /project
ENV PYTHONDONTWRITEBYTECODE=1 \
    PYTHONUNBUFFERED=1 \
    # 配置Python模块搜索路径，覆盖pyuno所在目录
    PYTHONPATH=/usr/lib/python3/dist-packages:/usr/lib/libreoffice/program

COPY . .
RUN apt-get update && apt-get install --no-install-recommends -y \
    # LibreOffice及转换依赖
    libreoffice-common libreoffice-core libreoffice-writer unoconv python3-uno \
    # 原有编译类依赖
    gcc libc-dev libpq-dev python-dev libxml2-dev libxslt1-dev python3-lxml \
    # 中文字体（可选，解决中文文档转码乱码问题）
    fonts-wqy-microhei fonts-wqy-zenhei \
    cron && \
    # 清理apt缓存减小镜像体积
    apt-get clean && rm -rf /var/lib/apt/lists/* && \
    pip install --no-cache-dir -r requirements.txt

镜像构建完成进入容器后，先执行python -c "import uno"，无报错则说明模块加载正常，此时直接执行doc2pdf 待转换文件名.docx即可完成格式转换。

注意：如果转换时出现LibreOffice启动超时/失败的问题，可以在执行转换命令时加--headless参数指定无界面模式，或提前启动一个常驻的uno监听进程避免重复启动开销。

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