如何在Django的settings.py中配置多个STATIC_ROOT部署目录？

为什么会报错 #

Django的STATIC_ROOT设计上只能接收单个字符串路径，不能是列表。它的作用是指定collectstatic命令收集所有静态文件后的统一存放目录，用于生产环境部署，本身不支持分散到多个目录。

正确解决思路 #

根据你的需求分两种情况处理：

情况1：需要将静态文件部署到多个本地/远程目录

STATIC_ROOT无法直接实现，可通过自定义管理命令来完成多目录同步：

1. 保留默认的STATIC_ROOT作为主收集目录（单个路径）
2. 编写自定义命令，先执行标准的collectstatic收集文件到主目录，再将文件复制到多个目标目录

自定义命令示例：
在你的Django应用下创建management/commands/multi_collectstatic.py（需先创建management和commands目录，并在每个目录下添加空的__init__.py文件）：

import os
import shutil
from django.core.management.base import BaseCommand
from django.conf import settings
from django.core.management.commands.collectstatic import Command as CollectStaticCommand

class Command(BaseCommand):
    help = '收集静态文件到多个指定目录'

    def handle(self, *args, **options):
        # 先执行默认collectstatic，将文件收集到主STATIC_ROOT
        collect_cmd = CollectStaticCommand()
        collect_cmd.handle(*args, **options)

        # 定义需要同步的多个目标目录（注意：必须是本地文件系统路径，不能是URL）
        target_dirs = [
            os.path.join(settings.BASE_DIR, 'Application', 'templates/Application'),
            os.path.join(settings.BASE_DIR, 'Domains', 'static_dist'),
        ]

        # 遍历目标目录，复制静态文件
        for target_dir in target_dirs:
            os.makedirs(target_dir, exist_ok=True)
            # 遍历主静态目录的所有文件，保持目录结构复制
            for root, _, files in os.walk(settings.STATIC_ROOT):
                for file in files:
                    src_file = os.path.join(root, file)
                    rel_path = os.path.relpath(src_file, settings.STATIC_ROOT)
                    dest_file = os.path.join(target_dir, rel_path)
                    os.makedirs(os.path.dirname(dest_file), exist_ok=True)
                    shutil.copy2(src_file, dest_file)
            self.stdout.write(self.style.SUCCESS(f'静态文件已同步到目录：{target_dir}'))

使用方法：
执行自定义命令代替标准collectstatic：

python3 manage.py multi_collectstatic

情况2：误解了STATIC_ROOT的作用，实际是想读取多个静态源文件

如果你的需求是让Django加载多个目录下的静态文件，那么你已经配置正确的STATICFILES_DIRS就是干这个的——它用于指定额外的静态文件源目录，Django会自动从这些目录读取静态文件，最终通过collectstatic统一收集到STATIC_ROOT中。

关键错误纠正 #

你之前的配置中把https://example.com放到STATIC_ROOT里是错误的：

• STATIC_ROOT必须是本地文件系统的绝对/相对路径，不能是URL
• 如果要部署到CDN或远程存储，需使用django-storages等第三方库配置对应存储后端，而非修改STATIC_ROOT

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