Django REST框架配置异常：无法加载设置及显示筛选按钮

一、解决“看不到Filters按钮”的问题 #

1. 确认安装django-filter依赖包，未安装则执行：

   pip install django-filter
   

2. 在settings.py的INSTALLED_APPS中添加django_filters：

   INSTALLED_APPS = [
       # 其他已有应用
       'django_filters',
   ]
   

3. 配置DRF的筛选后端，可选择全局或视图级配置：
   • 全局配置（在settings.py中）：

     REST_FRAMEWORK = {
         'DEFAULT_FILTER_BACKENDS': ['django_filters.rest_framework.DjangoFilterBackend'],
     }
     

   • 视图级配置（针对特定视图）：

     from django_filters.rest_framework import DjangoFilterBackend
     from rest_framework.generics import ListAPIView
     from .models import Product
     from .serializers import ProductSerializer
     
     class ProductListView(ListAPIView):
         queryset = Product.objects.all()
         serializer_class = ProductSerializer
         filter_backends = [DjangoFilterBackend]
         filterset_fields = ['id']  # 指定允许筛选的Product ID字段
     

4. 确保使用DRF提供的可浏览API视图基类（如ListAPIView、ModelViewSet等），自定义APIView需手动实现筛选逻辑才能显示Filters按钮。

二、解决ImproperlyConfigured配置错误 #

1. 检查manage.py和wsgi.py中的环境变量设置，确保DJANGO_SETTINGS_MODULE指向正确的项目配置：

   # manage.py 示例
   os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'your_project_name.settings')
   

   替换your_project_name为实际项目名称。
2. 确保在项目根目录下执行Django命令（如python manage.py runserver），避免在子目录运行导致配置路径错误。
3. 若使用IDE运行服务，检查运行配置的环境变量，添加DJANGO_SETTINGS_MODULE，值为your_project_name.settings。
4. 排查settings.py的语法错误，比如缺失逗号、括号不匹配等，这类错误会导致配置无法正常加载。
5. 若通过自定义脚本启动服务，需手动初始化Django配置：

   import os
   import django
   
   os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'your_project_name.settings')
   django.setup()
   

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