运行uWSGI触发AppRegistryNotReady错误的原因及中文路径疑问

一、AppRegistryNotReady: Apps aren't loaded yet. 错误原因及解决方法 #

这个错误的核心问题是：在Django的应用注册表（App Registry）完成初始化之前，你就导入了依赖Django模型或应用组件的模块。

为什么runserver和manage.py check没问题？ #

python manage.py runserver和manage.py check这类Django内置命令，会自动触发Django的完整初始化流程——包括加载设置、注册所有应用、初始化数据库连接等。而uWSGI在加载wsgi.py时，是直接执行脚本内容，如果脚本中提前导入了依赖Django应用的模块（比如你的sio视图，它又导入了User模型），此时Django还没完成应用注册，就会抛出这个错误。

从报错栈也能明确看到：

在wsgi.py第18行导入sio → 该视图导入了User模型 → 模型依赖Django的AbstractUser → 初始化AbstractBaseUser时需要检查应用注册表，此时注册表未就绪。

解决方法 #

调整wsgi.py的导入顺序，确保依赖Django应用的模块在Django初始化完成后再导入：

方案1：延迟导入到application初始化之后

修改你的wsgi.py，将需要Django环境的导入放在get_wsgi_application()之后：

import os
from django.core.wsgi import get_wsgi_application

# 先设置并初始化Django环境
os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'Qiyun02.settings')
application = get_wsgi_application()

# 等到Django应用加载完成后，再导入依赖模块
from 管理员后台.网站管理.admin_website_chat.views import sio

方案2：手动触发Django初始化（如果必须提前导入）

如果你的业务逻辑需要提前导入这些模块，可以在导入前手动调用django.setup()：

import os
import django

# 先设置settings模块
os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'Qiyun02.settings')
# 手动初始化Django环境
django.setup()

# 现在可以安全导入依赖模块了
from django.core.wsgi import get_wsgi_application
from 管理员后台.网站管理.admin_website_chat.views import sio

application = get_wsgi_application()

二、uWSGI对非拉丁字符（中文路径）的支持情况 #

uWSGI本身是支持中文等非拉丁字符路径的，但需要满足以下几个条件，避免路径解析错误：

• 确保系统环境编码为UTF-8：
  检查系统的LANG和LC_ALL环境变量，确保设置为UTF-8编码（比如en_US.UTF-8或zh_CN.UTF-8）。可以在uWSGI的配置文件（uwsgi.ini）中添加环境变量配置：

  env = LANG=en_US.UTF-8
  env = LC_ALL=en_US.UTF-8
  

• 确保Python编码设置正确：
  Python 3默认使用UTF-8编码，基本无需额外配置，但如果遇到编码问题，可以在wsgi.py开头添加（Python 2适用，Python 3可省略）：

  import sys
  sys.setdefaultencoding('utf-8')
  

• 配置文件保存为UTF-8编码：
  如果uwsgi.ini中包含中文路径，要确保配置文件本身以UTF-8编码保存，避免uWSGI解析路径时出现乱码。

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