为什么使用django-constance时会偶发ImportError报错？

可能原因 #

• django-constance 2.8.x版本懒加载逻辑缺陷：2.8版本重构了config实例的懒加载实现，constance/__init__.py中的LazyObject初始化时，会间接依赖constance.base模块的Config类，而base模块初始化又依赖上层已完成初始化的config实例，当导入过程被请求打断时就会触发循环导入报错。
• gunicorn多进程启动竞态：prefork模式下master进程部分加载constance模块后fork出worker进程，worker进程补全模块导入的流程和请求触发的config访问同时发生时，就会随机触发该报错。
• 导入时机不合理：如果项目的AppConfig、中间件、上下文处理器的顶层代码直接访问config属性，会提前触发constance模块初始化，大幅提升竞态出现概率。

解决方案 #

临时快速修复 #

• 降级django-constance版本到2.7.*：2.7版本未引入2.8的懒加载重构逻辑，可直接规避该问题。
• 调整gunicorn启动参数：添加--preload参数，让master进程在fork worker前完成所有模块的全量加载，彻底避免worker进程内的导入竞态，生产环境使用该参数时需注意会关闭代码热重载功能。
• 调整代码导入逻辑：将所有模块顶层的config属性访问逻辑，移动到对应方法内部（如AppConfig的ready()方法、中间件的请求处理方法内），避免模块导入阶段触发constance初始化。

适配2.8.x版本的永久修复 #

• 给django-constance打本地补丁：在constance/__init__.py的最开头添加导入语句from .base import Config，确保Config类在懒加载逻辑执行前已完成导入，切断循环导入路径。
• 替换config导入方式：放弃默认的懒加载实例，手动初始化config实例：

# 不要使用 from constance import config
from constance.base import Config
from django.conf import settings
config = Config(settings.CONSTANCE_CONFIG)

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