Django REST自定义Throttle报ImportError无法导入类问题

这个报错是DRF加载配置的限流类路径时，无法从指定模块拿到对应类对象导致的，常见触发原因有以下几种：

• 最高发原因：api/api_views.py中漏写UserRateThrottle的导入语句，自定义限流类继承的父类未定义，导致整个api_views模块加载时抛出NameError。DRF捕获模块加载异常后，不会抛出原始错误，只会统一返回「模块未定义对应类」的包装提示，很容易误导排查方向。
• api文件夹缺少__init__.py文件：Python要求可导入的包目录必须存在该文件（内容可以为空），缺失的话无法识别api为合法包，自然无法导入内部的api_views模块。
• api应用未在settings.py的INSTALLED_APPS中注册，Django不会将该应用目录加入Python导包搜索路径，导致找不到对应模块。
• 存在循环导入问题：比如api_views.py中直接或间接导入了settings.py内的配置，而settings.py启动时又要加载api_views里的限流类，两边互相等待对方加载完成，最终模块只加载了一半，找不到目标类。
• 类名或路径拼写错误：Python导包是大小写敏感的，如果类名大小写写错、路径层级写错，也会触发该报错。

按以下顺序排查修复即可：

• 先补全必要导入：打开api/api_views.py，在文件最顶部添加父类导入语句：

  from rest_framework.throttling import UserRateThrottle
  

  90%以上的同类报错都是漏写这行导入导致的。
• 检查api目录下是否存在空的__init__.py文件，没有的话手动新建即可。
• 打开settings.py，确认INSTALLED_APPS列表中已经添加了api应用。
• 快速定位真实错误：在项目根目录执行命令python manage.py shell，进入Django交互环境后手动执行导入：

  from api.api_views import BurstRateThrottle
  

  这行命令会直接抛出未被DRF包装的原始错误，如果是循环导入、拼写错误、依赖缺失等问题，会直接打印准确的错误栈，不用盲目排查。
• （推荐优化）不要把限流类和视图代码混放在api_views.py中，单独在api目录下新建throttles.py存放自定义限流类，之后把settings.py里的限流类路径改成api.throttles.BurstRateThrottle、api.throttles.SustainedRateThrottle，从根源上避免和视图逻辑产生循环导入。

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