Docker部署Django报错：找不到manage.py文件的原因与解决方法

错误原因 #

1. 路径匹配错误：你的manage.py实际位于项目的project子目录下（本地路径./project/manage.py），但容器中执行的命令python3 manage.py runserver是在/app目录下查找文件，自然找不到。
2. Windows系统的潜在影响：Windows的文件路径分隔符（\）与Linux容器的/可能存在映射问题，加上Docker卷挂载时如果未正确配置文件共享，可能导致本地目录未正确同步到容器内，但这是次要因素，核心还是路径不匹配。

解决方法 #

方法一：修正容器启动命令（最快） #

修改docker-compose.yml中的command字段，指定manage.py的正确路径：

version: '3'
services:
web:
    build: .
    command: python3 project/manage.py runserver 0.0.0.0:8000
    volumes:
      - .:/app
    ports:
      - "8000:8000"
    depends_on:
      - db

方法二：调整Dockerfile的工作目录 #

修改Dockerfile，将工作目录切换到manage.py所在的project目录：

FROM python:3
ENV PYTHONUNBUFFERED 1
RUN mkdir /app
WORKDIR /app
COPY requirements.txt /app/
RUN pip install -r requirements.txt
COPY . /app/
# 切换到manage.py所在的子目录
WORKDIR /app/project

保持docker-compose.yml中的命令不变即可。

方法三：调整本地项目目录结构（可选） #

将project目录下的manage.py和内层project子目录移到与docker-compose.yml同级，让manage.py直接位于项目根目录，这样容器内/app目录下就能直接找到它。调整后的目录结构：

├── project
│   ├── __init__.py
│   ├── asgi.py
│   ├── setting.py
│   ├── urls.py
│   └── wsgi.py
├── manage.py
├── docker-compose.yml
├── Dockerfile
└── requirements.txt

额外检查（针对Windows系统） #

确保Docker Desktop已开启文件共享功能（设置->资源->文件共享，勾选项目所在的磁盘分区），避免卷挂载时本地文件无法同步到容器内。

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