Docker容器中pdf2image的convert_from_path函数调用失败求助

问题症状 #

Python项目在本地Windows运行正常，但在Linux Docker容器中调用convert_from_path时，始终报错：

Unable to get page count. Is poppler installed and in PATH?

已尝试三种调用方式均失败：

• 通过环境变量POPPLER_PATH指定挂载的Windows本地Poppler目录
• 不指定Poppler路径
• 直接指定路径r'\usr\local\bin'

错误原因分析 #

1. 跨平台二进制不兼容：挂载Windows的Poppler目录到Linux容器毫无意义——Windows的可执行文件无法在Linux环境运行。
2. 路径格式错误：代码中使用Windows风格的反斜杠路径r'\usr\local\bin'，Linux系统需要正斜杠路径，且apt-get安装的poppler-utils二进制文件实际位于/usr/bin。
3. 环境变量指向无效路径：POPPLER_PATH指向的是无用的挂载目录，而非容器内正确的poppler路径。

解决方案 #

1. 移除无效的Docker Compose挂载 #

删除Docker Compose中关于Windows Poppler的绑定挂载配置：

# 删掉以下无效配置
- type: bind
  source: "C:/Program Files/poppler-0.68.0/bin"
  target: /code/poppler

2. 修正代码中的路径错误 #

直接依赖容器系统PATH中的poppler（apt安装后已自动加入PATH），或手动指定正确的Linux路径：

from pdf2image import convert_from_path
import os
from sys import exit

def my_function(file_source_path):
    try:
        # 优先使用系统PATH中的poppler，无需指定路径
        pages = convert_from_path(file_source_path, 600)
        return pages
    except Exception as e:
        print('首次尝试失败:', e)
        try:
            # 手动指定容器内poppler的正确路径
            pages = convert_from_path(file_source_path, 600, poppler_path='/usr/bin')
            return pages
        except Exception as e2:
            print('二次尝试失败:', e2)
            exit('退出脚本')

3. 验证容器内poppler是否正常安装 #

进入运行中的容器，执行以下命令确认poppler工具可用：

docker exec -it <容器ID> bash
pdftotext --version

若能输出版本信息，说明poppler已正确安装并在PATH中。

4. 重建Docker镜像 #

确保Dockerfile配置正确后，重新构建镜像：

docker-compose build

最终有效配置 #

Dockerfile（保持原有配置即可） #

FROM python:3.10

WORKDIR /code

# install poppler
RUN apt-get update
RUN apt-get install poppler-utils -y

COPY ./requirements.txt ./
RUN pip install --upgrade pip
RUN pip install --no-cache-dir -r requirements.txt

COPY . .

CMD ["python", "./app.py"]

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