添加corsheaders和whitenoise后Django启动报错：INSTALLED_APPS需为列表/元组

1. 修正INSTALLED_APPS的基础定义格式 #

Django明确要求INSTALLED_APPS必须是列表（[]）或元组（()），直接替换掉原有的大括号{}定义即可：

列表格式示例 #

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    # 添加你需要的第三方包
    'corsheaders',
    'whitenoise.runserver_nostatic',
]

元组格式示例（注意末尾元素的逗号） #

INSTALLED_APPS = (
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'corsheaders',
    'whitenoise.runserver_nostatic',
)

2. 排查环境变量加载的问题 #

如果依赖环境变量配置INSTALLED_APPS，重点检查这几点：

• 环境变量的取值必须是合法的JSON数组字符串，比如格式应为["django.contrib.admin", "corsheaders", ...]，不能是集合格式的字符串
• 检查键名的空格：你代码里的os.environ.get('INSTALLED_APPS ')末尾多了空格，正确键名应为'INSTALLED_APPS'，修正后代码示例：

import json
import os

# 默认值设为空列表避免加载失败
INSTALLED_APPS = json.loads(os.environ.get('INSTALLED_APPS', '[]'))

• 验证环境变量是否生效：终端执行echo $INSTALLED_APPS（Linux/macOS）或echo %INSTALLED_APPS%（Windows），确认输出是标准JSON数组

3. 提前验证配置合法性 #

修改配置后先执行python manage.py check命令，该命令会扫描Django配置的合法性，提前排查其他潜在问题，确认无报错后再启动服务python manage.py runserver

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