如何在Django REST Framework处理请求前修改URL参数（query_string）？

在Django/DRF中，直接修改request.META['QUERY_STRING']无效的核心原因是：Django在请求初始化阶段已经将查询字符串解析为request.GET（DRF中对应request.query_params）的不可变QueryDict对象，后续修改QUERY_STRING不会自动同步到已解析的参数集合中。以下是两种可行的实现方案：

方案一：全局中间件（推荐，适用于所有接口） #

自定义中间件直接修改解析后的查询参数，同时同步更新QUERY_STRING，确保全局接口都能兼容旧客户端：

from django.http import QueryDict
from django.utils.deprecation import MiddlewareMixin

class LegacyParamMiddleware(MiddlewareMixin):
    def process_request(self, request):
        # 复制原查询参数，转为可变对象（默认QueryDict不可修改）
        updated_params = request.GET.copy()
        has_changes = False

        # 1. 将pk参数替换为id
        if 'pk' in updated_params:
            updated_params['id'] = updated_params.pop('pk')
            has_changes = True

        # 2. 将displayName参数替换为display_name
        if 'displayName' in updated_params:
            updated_params['display_name'] = updated_params.pop('displayName')
            has_changes = True

        # 3. 将逗号分隔的target参数拆分为多值参数
        if 'target' in updated_params:
            target_list = updated_params['target'].split(',')
            if len(target_list) > 1:
                updated_params.pop('target')
                for val in target_list:
                    updated_params.appendlist('target', val.strip())
                has_changes = True

        if has_changes:
            # 更新request.GET和QUERY_STRING，确保后续流程使用修改后的参数
            request.GET = updated_params
            request.META['QUERY_STRING'] = updated_params.urlencode()

在项目settings.py的MIDDLEWARE列表中注册该中间件（建议放在DRF相关中间件之前）：

MIDDLEWARE = [
    # ... 其他系统中间件
    'your_app.middleware.LegacyParamMiddleware',
    # ... DRF相关中间件（如rest_framework.middleware.AuthenticationMiddleware）
]

方案二：视图层局部处理（仅适用于特定接口） #

如果只需要在单个/部分DRF视图中处理兼容逻辑，可重写视图的initial方法：

from rest_framework import generics

class ExerciseListView(generics.ListAPIView):
    queryset = Exercise.objects.all()
    serializer_class = ExerciseSerializer
    # ... 其他视图配置

    def initial(self, request, *args, **kwargs):
        super().initial(request, *args, **kwargs)
        updated_params = request.query_params.copy()
        has_changes = False

        # 执行和中间件相同的参数修改逻辑
        if 'pk' in updated_params:
            updated_params['id'] = updated_params.pop('pk')
            has_changes = True
        if 'displayName' in updated_params:
            updated_params['display_name'] = updated_params.pop('displayName')
            has_changes = True
        if 'target' in updated_params:
            target_list = updated_params['target'].split(',')
            if len(target_list) > 1:
                updated_params.pop('target')
                for val in target_list:
                    updated_params.appendlist('target', val.strip())
                has_changes = True

        if has_changes:
            request.query_params = updated_params
            request.META['QUERY_STRING'] = updated_params.urlencode()

关键注意点 #

• 必须使用copy()方法复制QueryDict：默认的request.GET是不可变对象，直接修改会抛出异常，复制后得到可变版本才能进行参数调整。
• 同步更新QUERY_STRING：确保后续如日志、第三方依赖等读取QUERY_STRING时，也能拿到修改后的参数内容。

内容的提问来源于stack exchange，提问作者Tony.Luo