Django结合Docker部署时ImageField图片上传功能失效求助

问题描述 #

本地用python manage.py runserver运行时，ImageField可正常将图片上传至指定文件夹；但通过docker-compose部署后，图片无法上传，且docker logs <container-name>无任何报错信息。

已验证的配置信息 #

1. 本地目标文件夹/Works/app-media已挂载到容器内/app/media，挂载功能正常——在容器内/app/media创建文件可同步到本地对应目录。
2. 通过.env文件为settings.py加载MEDIA_URL和MEDIA_ROOT，已确认变量加载正常：

MEDIA_ROOT = os.getenv('MEDIA_ROOT', os.path.join(BASE_DIR, 'media'))
MEDIA_URL = os.getenv('MEDIA_URL', '/media/')

3. docker-compose.yml相关配置：

services:
  admin-backend-service:
    build:
      context: .
    container_name: admin-backend
    ports:
      - "8000:8000"
    volumes:
      - ./static:/app/static
      - /Works/app-media:/app/media
    environment:
      DEBUG: "0"
      ALLOWED_HOSTS: "admin.dypzen.com"
    restart: always

4. 博客文章Model中ImageField定义：

class Post(models.Model):
    author = models.ForeignKey(User, on_delete=models.CASCADE)
    title = models.CharField(max_length=200)
    subtitle = models.CharField(max_length=200, blank=True)
    content = models.TextField()
    image = models.ImageField(upload_to='blog_images', blank=True, null=True)
    video = models.FileField(upload_to='blog_videos', blank=True, null=True)

补充排查 #

已移除docker-compose.yml中的DEBUG: "0"配置，但问题仍存在。

解决方向 #

1. 检查容器内目录权限 #

Docker容器运行用户可能没有/app/media/blog_images和/app/media/blog_videos的写入权限：

• 进入容器：docker exec -it admin-backend bash
• 查看目录权限：ls -ld /app/media /app/media/blog_images
• 若权限不足，手动创建目录并设置权限：

mkdir -p /app/media/blog_images /app/media/blog_videos
chmod -R 755 /app/media
chown -R www-data:www-data /app/media  # 若Django用其他用户运行，替换为对应用户名

2. 确认MEDIA_ROOT实际值 #

在容器内通过Django Shell验证MEDIA_ROOT是否指向挂载目录：

docker exec -it admin-backend python manage.py shell

在Shell中执行：

import os
from django.conf import settings
print(settings.MEDIA_ROOT)

若输出不是/app/media，说明.env变量未正确加载，需在docker-compose.yml的admin-backend-service下添加：

env_file:
  - .env

3. 调整日志级别排查隐藏错误 #

非DEBUG模式下文件上传日志可能未输出，在settings.py中添加日志配置：

LOGGING = {
    'version': 1,
    'disable_existing_loggers': False,
    'handlers': {
        'console': {'class': 'logging.StreamHandler'},
    },
    'root': {
        'handlers': ['console'],
        'level': 'INFO',
    },
    'loggers': {
        'django': {
            'handlers': ['console'],
            'level': os.getenv('DJANGO_LOG_LEVEL', 'INFO'),
            'propagate': False,
        },
    },
}

重启容器后上传图片，查看日志获取错误信息。

4. 检查Dockerfile的工作目录与用户 #

若Dockerfile设置了非root用户运行Django，需确保该用户对/app/media有写入权限。例如Dockerfile中有：

RUN useradd -m myuser
USER myuser

则需在容器启动时自动设置目录所有者，或在docker-compose.yml中添加启动命令：

command: bash -c "chown -R myuser:myuser /app/media && python manage.py runserver 0.0.0.0:8000"

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