通过Supervisor启动Daphne报ImproperlyConfigured错误如何解决

Supervisor 启动子进程时默认不继承当前登录用户的 shell 环境变量，你配置的 DJANGO_SETTINGS_MODULE 系统变量仅在手动登录的 shell 会话中生效，Supervisor 运行 Daphne 时读取不到该变量，因此触发 Django 配置报错。该问题和虚拟环境运行逻辑无关，属于 Supervisor 环境变量传递机制导致的问题。

推荐按优先级选择以下方案：

• 方案1（最推荐）：在 Supervisor 配置中显式声明环境变量
  在你的 [fcgi-program:asgi] 配置块中新增 environment 配置项，把项目需要的所有环境变量统一声明即可，示例：

  [fcgi-program:asgi]
  # 保留你原来的所有配置，新增下面一行
  environment=DJANGO_SETTINGS_MODULE="mysite.settings",DJANGO_SECRET_KEY="你的项目密钥"
  

  多个环境变量之间用英文逗号分隔，变量值包含特殊字符时需要用双引号包裹。

• 方案2：在启动命令中注入环境变量
  直接修改 Supervisor 的 command 配置，运行 Daphne 前先声明所需环境变量，示例：

  command=bash -c "export DJANGO_SETTINGS_MODULE=mysite.settings && /srv/venv/bin/daphne -u /srv/run/daphne/daphne%(process_num)d.sock --fd 0 --access-log - --proxy-headers mysite.asgi:application"
  

• 方案3：修改项目 asgi.py 固定配置
  检查项目根目录的 asgi.py 文件，确认顶部已经显式指定了 settings 模块路径，如缺失则补充：

  import os
  os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'mysite.settings') # 替换为你实际的settings路径
  

注：修改完配置后需要执行以下命令让配置生效：

1. 重载配置：supervisorctl reread
2. 更新进程组：supervisorctl update
3. 重启asgi进程：supervisorctl restart asgi:*

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