如何基于Django配置切换ImageField存储：本地与Azure后端切换

完全可以通过配置项结合条件判断实现本地与生产环境的存储方案切换，下面提供两种常用实现方式：

方法一：全局配置默认存储（推荐） #

这种方式无需修改模型代码，通过settings.py根据环境动态设置默认存储后端，是最简洁易维护的方案。

在settings.py中添加以下配置：

import os

# 根据环境变量判断当前运行环境
if os.environ.get("DJANGO_ENV") == "production":
    # 生产环境使用Azure存储
    DEFAULT_FILE_STORAGE = "storages.backends.azure_storage.AzureMediaStorage"
    # 配置Azure存储的必要参数（建议从环境变量读取，避免硬编码）
    AZURE_ACCOUNT_NAME = os.environ.get("AZURE_ACCOUNT_NAME")
    AZURE_ACCOUNT_KEY = os.environ.get("AZURE_ACCOUNT_KEY")
    AZURE_MEDIA_CONTAINER = "profile-pics"
else:
    # 本地环境使用Django默认的文件系统存储
    DEFAULT_FILE_STORAGE = "django.core.files.storage.FileSystemStorage"

模型代码保持统一即可，无需区分环境：

image = models.ImageField(upload_to="profile_pics", blank=True, null=True)

方法二：模型字段内直接使用条件判断 #

如果需要针对个别字段单独设置存储方案，可以在模型中直接通过条件判断赋值storage参数：

from django.conf import settings
from storages.backends.azure_storage import AzureMediaStorage

class YourModel(models.Model):
    # 根据DEBUG状态或自定义环境变量切换存储
    if settings.DEBUG:
        image = models.ImageField(upload_to="profile_pics", blank=True, null=True)
    else:
        image = models.ImageField(
            upload_to="profile_pics",
            blank=True,
            null=True,
            storage=AzureMediaStorage()
        )

注意事项 #

• 建议使用环境变量（如DJANGO_ENV）来区分环境，比依赖DEBUG更灵活（比如测试环境也可能需要使用Azure存储）。
• Azure的敏感配置（如AZURE_ACCOUNT_KEY）必须通过环境变量读取，绝对不能硬编码到代码中。

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