Django设置DEBUG=False时图片无法显示的问题及部署咨询

一、核心问题分析 #

当DEBUG=False时，Django不会自动处理静态文件（static）和媒体文件（media）的HTTP请求，这是导致图片无法显示的根本原因。同时你的配置存在小瑕疵，需要调整后才能适配生产/开发环境的DEBUG=False状态。

二、配置调整步骤 #

1. 修正settings.py静态文件配置 #

你当前的STATIC_ROOT存在重复赋值问题，调整为更清晰的逻辑：

import os
from pathlib import Path

BASE_DIR = Path(__file__).resolve().parent.parent

DEBUG = False

STATIC_URL = '/static/'
# 统一指定静态文件收集目录，无论DEBUG状态
STATIC_ROOT = os.path.join(BASE_DIR, 'staticfiles')
MEDIA_URL = '/media/'
MEDIA_ROOT = os.path.join(BASE_DIR, 'media')

if DEBUG:
    # 仅DEBUG=True时，额外加载项目根目录的static文件夹
    STATICFILES_DIRS = [os.path.join(BASE_DIR, 'static')]

2. 收集静态文件 #

执行以下命令，将所有App的静态文件、STATICFILES_DIRS中的文件复制到STATIC_ROOT目录：

python manage.py collectstatic

执行时确认覆盖提示，确保staticfiles目录包含所有静态资源。

3. 媒体文件访问处理 #

django.conf.urls.static.static()仅在DEBUG=True时生效，DEBUG=False时需由Web服务器（如Apache）直接处理/media/路径的请求。

三、Apache部署可行性及配置 #

部署到Apache完全可行，需完成以下配置：

1. 确保安装mod_wsgi：将Django项目通过WSGI协议挂载到Apache。
2. 配置虚拟主机：添加静态文件和媒体文件的别名映射，示例配置如下：

<VirtualHost *:80>
    ServerName your-domain.com

    # 静态文件映射
    Alias /static/ /your-project-path/staticfiles/
    <Directory /your-project-path/staticfiles/>
        Require all granted
    </Directory>

    # 媒体文件映射
    Alias /media/ /your-project-path/media/
    <Directory /your-project-path/media/>
        Require all granted
    </Directory>

    # WSGI应用配置
    WSGIScriptAlias / /your-project-path/wsgi.py
    <Directory /your-project-path/>
        <Files wsgi.py>
            Require all granted
        </Files>
    </Directory>
</VirtualHost>

将/your-project-path/替换为你项目的实际根目录（manage.py所在目录）。

四、开发环境固定DEBUG=False的处理 #

如果开发环境也强制使用DEBUG=False，Django自带的runserver不会处理静态/媒体文件，推荐使用whitenoise库解决：

1. 安装依赖：

pip install whitenoise

2. 修改settings.py：

INSTALLED_APPS = [
    'whitenoise.runserver_nostatic',  # 放在最顶部
    'django.contrib.admin',
    # 其他App...
    'whitenoise',
]

MIDDLEWARE = [
    'django.middleware.security.SecurityMiddleware',
    'whitenoise.middleware.WhiteNoiseMiddleware',  # 放在SecurityMiddleware之后
    # 其他中间件...
]

配置完成后，runserver在DEBUG=False时即可正常服务静态和媒体文件。

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