Docker化Django/Python项目遇'backend'模块找不到错误求助

错误原因 #

ModuleNotFoundError: No module named 'backend' 源于Python模块路径与容器内目录结构不匹配：

• 你在本地backend目录执行构建，容器内WORKDIR被设为/app/backend，代码复制完成后，/app/backend下直接存放着api、menu_back等子目录，而非包含backend子目录。
• manage.py中设置的DJANGO_SETTINGS_MODULE = "backend.menu_back.settings"，要求Python在sys.path包含的路径下找到backend模块，但当前工作目录就是backend本身，Python无法在该目录下找到名为backend的子模块，因此触发错误。

解决方案1：修改Django配置（最简方案） #

直接调整menu_back/manage.py的设置，移除多余的backend前缀：

os.environ.setdefault("DJANGO_SETTINGS_MODULE", "menu_back.settings")

同时检查menu_back/settings.py中的INSTALLED_APPS，若存在backend.api这类配置，改为api：

INSTALLED_APPS = [
    # 其他默认应用
    'api',
    # 其他自定义应用
]

修改后重新构建镜像，即可正常运行容器。

解决方案2：调整Dockerfile目录配置 #

若不想修改Django代码，可通过调整Dockerfile的工作目录与复制逻辑，让Python正确识别backend模块：

# 使用官方Python 3.11.2镜像作为基础
FROM python:3.11.2

# 设置工作目录为/app
WORKDIR /app

# 复制本地backend目录下的requirements.txt到容器
COPY backend/requirements.txt .

# 安装依赖
RUN pip install --no-cache-dir -r requirements.txt

# 将本地backend目录的所有内容复制到容器的/app/backend下
COPY backend ./backend

# 设置PostgreSQL环境变量
ENV POSTGRESHOST=db
ENV POSTGRESPORT=5432
ENV POSTGRESUSER=postgres
ENV POSTGRESPASSWORD=mypassword
ENV POSTGRES_DB=mydatabase

# 切换到backend目录并启动服务
CMD cd backend && python menu_back/manage.py runserver 0.0.0.0:8000

# 暴露端口
EXPOSE 8000

此时容器内/app/backend为项目根目录，/app在Python默认sys.path中，backend.menu_back.settings可被正确识别。

验证方法 #

构建镜像后，可进入容器验证配置是否正确：

docker run -it --entrypoint bash backend-image
# 容器内执行以下命令
echo $PYTHONPATH
ls /app/backend
python -c "import backend.menu_back.settings"

若最后一条命令无报错，说明模块路径配置正确。

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