DRF中空字符串条目后置的字母升序排序需求及代码问题

问题分析 #

你当前的代码仅处理了空字符串的位置，但未加入字段本身的字母排序逻辑，因此只实现了空条目后置，却没达到字母升序的效果。另外，Django自带的nulls_last=True仅对NULL值生效，无法直接作用于空字符串('')。

方案一：不修改数据库，通过自定义排序条件实现 #

修正你的代码，让排序逻辑先区分空字符串和非空字符串（空的排最后），再对非空字段执行字母升序：

from django.db.models import Case, When, Value, F

def order_by_custom_fields(self, ordering: list):
    result = []
    for field in ordering:
        # 处理请求中可能的降序（字段名带负号）
        is_desc = field.startswith('-')
        actual_field = field.lstrip('-')
        
        # 空字符串标记：空条目返回1，非空返回0，升序时0在前、1在后（空条目排末尾）
        empty_case = Case(
            When(**{f"{actual_field}__exact": ''}, then=Value(1)),
            default=Value(0)
        )
        # 先按空字符串标记排序，再按字段本身排序
        result.append(empty_case)
        # 根据原请求的排序方向添加字段
        if is_desc:
            result.append(F(actual_field).desc())
        else:
            result.append(F(actual_field).asc())
    return result

def get_ordering(self, request, queryset, view):
    params = request.query_params.get(self.ordering_param)
    if params:
        fields = [param.strip() for param in params.split(',')]
        ordering = self.remove_invalid_fields(queryset, fields, view, request)
    else:
        ordering = []
    # 直接使用自定义排序条件替换原有逻辑
    return tuple(self.order_by_custom_fields(ordering))

def filter_queryset(self, request, queryset, view):
    ordering = self.get_ordering(request, queryset, view)
    if ordering:
        return queryset.order_by(*ordering)
    return queryset

关键说明 #

• 先通过Case生成空字符串标记，确保空条目排序权重更高（排末尾）
• 保留原请求的排序方向支持（升序/降序）
• 将空字符串标记的排序条件放在字段排序之前，保证先区分空/非空，再做字母排序

方案二：将空字符串改为NULL值，利用nulls_last原生API #

如果可以修改数据库字段的存储逻辑，将空字符串替换为NULL，就能直接使用Django的nulls_last参数简化代码：

1. 修改模型字段，允许存储NULL：

class YourModel(models.Model):
    field = models.CharField(max_length=255, blank=True, null=True)

2. 生成并执行数据库迁移，将现有空字符串批量更新为NULL：

# 数据更新示例（可放在迁移脚本或一次性执行）
YourModel.objects.filter(field='').update(field=None)

3. 在DRF排序中使用nulls_last：

from django.db.models import F

def filter_queryset(self, request, queryset, view):
    ordering = self.get_ordering(request, queryset, view)
    if ordering:
        ordered_queryset = queryset
        for field in ordering:
            is_desc = field.startswith('-')
            actual_field = field.lstrip('-')
            if is_desc:
                ordered_queryset = ordered_queryset.order_by(F(actual_field).desc(nulls_last=True))
            else:
                ordered_queryset = ordered_queryset.order_by(F(actual_field).asc(nulls_last=True))
        return ordered_queryset
    return queryset

优势 #

• 利用Django原生API，代码更简洁易维护
• 数据库对NULL值的排序优化更好，性能更稳定

内容的提问来源于stack exchange，提问作者Артём Беляков