Docker容器中已安装Python包无法访问的问题求助

你的核心问题出在Docker多阶段构建的隔离性上——每个FROM指令都会启动一个全新的独立构建阶段，不同阶段的内容不会自动共享。

看你的Dockerfile：

• 你在python:3阶段安装了lottie和cairosvg，但这个阶段的所有内容（包括Python环境、安装的包）都没有被传递到最后的alpine阶段。
• 最终的容器镜像只保留了alpine阶段的内容，加上从builder阶段复制的matterbridge二进制文件——整个镜像里根本没有Python环境，更别说你安装的那些包了，所以自然找不到lottie.py，pip3也不存在。

另外，python:3是基于Debian的镜像，你在里面执行的apt-get install libcairo2-dev也是无效操作，因为这个阶段的内容完全没被用到。

根据你的需求（需要在容器内运行Python脚本+使用matterbridge），可以选以下两种方案：

方案一：基于Python镜像构建最终容器（简单直接） #

如果不需要严格使用alpine的轻量镜像，直接用python:3作为最终基础镜像，整合所有依赖和产物：

# 第一阶段：构建matterbridge二进制文件
FROM alpine AS builder
COPY . /go/src/matterbridge
RUN apk --no-cache add go git
WORKDIR /go/src/matterbridge
RUN go build -mod vendor -o /bin/matterbridge

# 第二阶段：最终镜像，包含Python环境和所有依赖
FROM python:3
# 安装matterbridge和cairosvg需要的系统依赖
RUN apt-get update && apt-get install -y --no-install-recommends \
    ca-certificates mailcap libcairo2-dev && \
    rm -rf /var/lib/apt/lists/*  # 清理缓存减小镜像体积

# 安装Python包
RUN pip install --no-cache-dir --upgrade pip && \
    pip install --no-cache-dir lottie cairosvg

# 从builder阶段复制matterbridge
COPY --from=builder /bin/matterbridge /bin/matterbridge

# 配置matterbridge的目录和默认配置文件
RUN mkdir /etc/matterbridge \
    && touch /etc/matterbridge/matterbridge.toml \
    && ln -sf /matterbridge.toml /etc/matterbridge/matterbridge.toml

ENTRYPOINT ["/bin/matterbridge", "-conf", "/etc/matterbridge/matterbridge.toml"]

方案二：基于Alpine镜像构建（保持轻量） #

如果一定要用alpine的轻量镜像，需要在alpine里手动安装Python环境，并确保Python包正常安装：

# 第一阶段：构建matterbridge
FROM alpine AS builder
COPY . /go/src/matterbridge
RUN apk --no-cache add go git
WORKDIR /go/src/matterbridge
RUN go build -mod vendor -o /bin/matterbridge

# 第二阶段：预安装Python包（可选，加快构建速度）
FROM python:3 AS python-builder
RUN pip install --no-cache-dir --upgrade pip && \
    pip install --no-cache-dir lottie cairosvg -t /python-packages

# 第三阶段：最终Alpine镜像
FROM alpine
# 安装Alpine系统依赖：Python3、pip、cairosvg需要的库、matterbridge依赖
RUN apk --no-cache add \
    ca-certificates mailcap python3 py3-pip libcairo2-dev

# 复制预安装的Python包到Alpine的Python路径（或者直接用pip3重新安装）
COPY --from=python-builder /python-packages /usr/local/lib/python3.11/site-packages/
# 替代方案：直接在Alpine内安装
# RUN pip3 install --no-cache-dir lottie cairosvg

# 复制matterbridge二进制文件
COPY --from=builder /bin/matterbridge /bin/matterbridge

# 配置matterbridge目录
RUN mkdir /etc/matterbridge \
    && touch /etc/matterbridge/matterbridge.toml \
    && ln -sf /matterbridge.toml /etc/matterbridge/matterbridge.toml

ENTRYPOINT ["/bin/matterbridge", "-conf", "/etc/matterbridge/matterbridge.toml"]

构建镜像后，你可以进入容器检查：

docker run -it --entrypoint /bin/bash [你的镜像名]
# 然后执行以下命令验证
pip3 list  # 应该能看到lottie和cairosvg
python3 -c "import lottie; print(lottie.__version__)"  # 验证包能正常导入

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