单个Prefect流遇ModuleNotFoundError，另一流正常的部署问题求助

问题背景 #

• 基于Prefect v1.3.1（已升级至v1最新版本）的项目，使用Poetry做依赖管理（方案适配Hatch、Pipenv、Flit等工具）
• 原生代码迁移Docker化后，流注册阶段失败，核心报错为ModuleNotFoundError: No module named 'aid'，导致Docker镜像构建失败

报错日志 #

ModuleNotFoundError: No module named 'aid'

The command '/bin/sh -c python /opt/prefect/healthcheck.py '["/opt/prefect/flows/basic-pandas-flow.prefect"]' '(3, 10)'' returned a non-zero code: 1
Traceback (most recent call last):
...
ValueError: Your docker image failed to build!  Your flow might have failed one of its deployment health checks - please ensure that all necessary files and dependencies have been included.

解决方案 #

1. 修正Dockerfile，确保自定义模块被安装 #

问题根源是Docker镜像内未安装项目的aid模块，需要在Dockerfile中添加项目依赖及模块安装步骤：

• 复制项目的依赖配置文件（如pyproject.toml、poetry.lock）到镜像
• 安装所有依赖（包括项目自身）
• 复制项目源代码到镜像

示例Dockerfile片段：

# 复制依赖配置文件
COPY pyproject.toml poetry.lock /opt/prefect/
WORKDIR /opt/prefect/

# 安装Poetry并禁用虚拟环境（适配容器环境）
RUN pip install poetry
RUN poetry config virtualenvs.create false

# 安装所有依赖（包括项目模块）
RUN poetry install --no-dev

# 复制项目源代码
COPY . /opt/prefect/

2. 验证镜像内模块可用性 #

构建镜像后，手动进入容器验证模块是否能被导入：

docker run -it <镜像名> bash
python -c "import aid"

如果导入成功，说明模块已正确安装；若仍报错，检查Python的sys.path是否包含项目目录。

3. 确认Prefect健康检查逻辑 #

Prefect的healthcheck.py会在构建镜像时验证流依赖的模块是否存在，完成上述步骤后，健康检查即可通过。

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