如何在多Docker服务间共享Python模块，解决导入报错问题？

目前的问题是每个服务容器内仅包含自身代码，shared_module不在容器的文件系统中，也未加入Python的搜索路径，导致导入失败。以下是几种可行的修改方案：

方案一：复制共享模块到容器并配置Python路径（适合生产环境） #

1. 修改docker-compose.yml的构建上下文 #

将每个服务的build配置改为以项目根目录为上下文，同时指定服务的Dockerfile路径：

version: '3.3'

services:
  service1:
    build:
      context: .
      dockerfile: service1/Dockerfile
    command: python3 main.py
    ports:
      - 8012:8012

  service2:
    build:
      context: .
      dockerfile: service2/Dockerfile
    command: python3 main.py
    ports:
      - 8013:8013

2. 修改服务的Dockerfile #

以service1/Dockerfile为例（service2同理），添加复制shared_module的步骤，并设置PYTHONPATH环境变量：

FROM python:3.11-slim

WORKDIR /service1

# 从项目根目录复制共享模块到容器工作目录
COPY shared_module /service1/shared_module

# 设置Python路径，让解释器能找到shared_module
ENV PYTHONPATH="/service1:${PYTHONPATH}"

USER 1002

# 复制当前服务的代码到工作目录
COPY service1/. .

方案二：使用卷挂载共享模块（适合开发阶段） #

无需修改Dockerfile，直接在docker-compose.yml中通过volumes挂载本地的shared_module到容器，并配置Python路径：

version: '3.3'

services:
  service1:
    build: service1/.
    command: python3 main.py
    ports:
      - 8012:8012
    volumes:
      - ./shared_module:/service1/shared_module
    environment:
      - PYTHONPATH=/service1:${PYTHONPATH}

  service2:
    build: service2/.
    command: python3 main.py
    ports:
      - 8013:8013
    volumes:
      - ./shared_module:/service2/shared_module
    environment:
      - PYTHONPATH=/service2:${PYTHONPATH}

这种方式的优势是本地修改shared_module后，容器会立即生效，无需重新构建镜像。

方案三：将共享模块打包为可安装的Python包（适合长期维护） #

1. 给shared_module添加打包配置 #

在stack-example/shared_module目录下创建pyproject.toml文件：

[build-system]
requires = ["setuptools>=61.0"]
build-backend = "setuptools.build_meta"

[project]
name = "shared_module"
version = "0.1.0"

2. 修改docker-compose.yml的构建上下文 #

同方案一，将每个服务的build上下文改为项目根目录：

version: '3.3'

services:
  service1:
    build:
      context: .
      dockerfile: service1/Dockerfile
    command: python3 main.py
    ports:
      - 8012:8012

  service2:
    build:
      context: .
      dockerfile: service2/Dockerfile
    command: python3 main.py
    ports:
      - 8013:8013

3. 修改服务的Dockerfile #

以service1/Dockerfile为例，添加安装共享模块的步骤：

FROM python:3.11-slim

WORKDIR /service1

# 复制共享模块并安装到Python环境
COPY shared_module /tmp/shared_module
RUN pip install /tmp/shared_module

USER 1002

# 复制当前服务的代码
COPY service1/. .

这种方式将共享模块作为正式的Python包管理，后续模块更新时只需调整版本号重新构建即可。

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