Railway.app部署Django项目时Weasyprint依赖gobject-2.0-0加载失败

问题描述 #

使用以下Dockerfile配置Django项目，在Railway.app上构建和部署流程正常，但运行时出现库加载失败错误：

FROM python:3.12.2-slim-bullseye

# Install system dependencies
RUN apt-get update && apt-get install -y \
    python3-pip \
    python3-cffi \
    python3-brotli \
    libpango1.0-0 \
    libpangoft2-1.0-0 \
    libharfbuzz-subset0 \
    libffi-dev \
    libcairo2 \
    libcairo2-dev \
    libjpeg62-turbo-dev \
    libgdk-pixbuf2.0-0 \
    libgdk-pixbuf2.0-dev \
    libgobject-2.0-0 \
    libgobject2.0-dev \
    build-essential \
    && apt-get clean

ENV LD_LIBRARY_PATH=/usr/lib:/usr/local/lib:/usr/lib/x86_64-linux-gnu:$LD_LIBRARY_PATH

# Set the working directory
WORKDIR /PAQSBackend

# Copy the application code
COPY . /PAQSBackend/
RUN pip install -r requirements.txt

COPY PAQSBackend.wsgi /PAQSBackend/PAQSBackend.wsgi
CMD ["gunicorn", "--bind", "0.0.0.0:8000", "PAQSBackend.wsgi"]

错误日志：

File "/opt/venv/lib/python3.11/site-packages/cffi/api.py", line 827, in loadbackend_lib
raise OSError(msg)
OSError: cannot load library 'gobject-2.0-0': gobject-2.0-0: cannot open shared object file: No such file or directory. Additionally, ctypes.util.find_library() did not manage to locate a library called 'gobject-2.0-0'

问题原因 #

1. 依赖不完整：gobject-2.0-0属于GLib库组件，仅安装libgobject-2.0-0缺少其核心依赖libglib2.0-0，导致库无法正常加载。
2. Slim镜像精简过度：Debian Slim镜像为缩小体积移除了部分库的符号链接或辅助文件，使得ctypes.util.find_library()无法识别库路径。
3. Python环境冲突：错误日志显示运行环境为Python3.11的虚拟环境，但Dockerfile指定的是Python3.12，Railway自动创建的虚拟环境与镜像内Python版本不匹配，导致依赖路径识别错误。

解决方法 #

方法1：补充完整系统依赖 #

在apt-get install列表中添加libglib2.0-0和libgirepository1.0-dev，这两个包是gobject库正常工作的必要支撑：

RUN apt-get update && apt-get install -y \
    python3-pip \
    python3-cffi \
    python3-brotli \
    libpango1.0-0 \
    libpangoft2-1.0-0 \
    libharfbuzz-subset0 \
    libffi-dev \
    libcairo2 \
    libcairo2-dev \
    libjpeg62-turbo-dev \
    libgdk-pixbuf2.0-0 \
    libgdk-pixbuf2.0-dev \
    libgobject-2.0-0 \
    libgobject2.0-dev \
    libglib2.0-0 \
    libgirepository1.0-dev \
    build-essential \
    && apt-get clean

方法2：调整库路径配置 #

修改LD_LIBRARY_PATH，明确添加glib库的专属路径，帮助系统定位库文件：

ENV LD_LIBRARY_PATH=/usr/lib/x86_64-linux-gnu/glib-2.0:/usr/lib:/usr/local/lib:$LD_LIBRARY_PATH

方法3：手动创建虚拟环境 #

避免Railway自动创建的虚拟环境版本冲突，手动在镜像内创建并指定使用虚拟环境：

WORKDIR /PAQSBackend

# 创建并激活虚拟环境
RUN python -m venv /opt/venv
ENV PATH="/opt/venv/bin:$PATH"

# 后续步骤不变
COPY . /PAQSBackend/
RUN pip install -r requirements.txt

COPY PAQSBackend.wsgi /PAQSBackend/PAQSBackend.wsgi
CMD ["gunicorn", "--bind", "0.0.0.0:8000", "PAQSBackend.wsgi"]

方法4：切换非精简镜像 #

如果以上方法无效，可使用完整的Debian基础镜像替代Slim版，它包含更完整的系统库：

FROM python:3.12.2-bullseye
# 后续依赖安装、代码复制等步骤保持不变

验证步骤 #

修改Dockerfile后，先本地测试确认：

1. 执行docker build -t paqs-backend .构建镜像
2. 运行docker run -p 8000:8000 paqs-backend，检查服务是否正常启动
3. 确认无问题后，提交代码到Railway触发重新部署，查看日志验证错误是否消失

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