Django视图添加booking_time__range日期范围筛选后无返回结果

问题现象 #

移除booking_time__range日期范围筛选条件时，视图可正常返回当前用户所属组织的全部预约数据；一旦添加该筛选条件，前端模板就不会渲染出任何预约结果，已连续多天自行排查未定位根因。

相关代码片段 #

预约模型定义 #

from django.db import models
from django.utils import timezone
from users.models import Account
from organization.models import Organization, Office


class Booking(models.Model):
    LOCATION_OPTIONS = (
            ('H', 'Home Office'),
            ('O', 'Office'),
            ('N', 'Not indicated'),
    )
    account             = models.ForeignKey(Account, on_delete=models.CASCADE)
    organization        = models.ForeignKey(Organization, on_delete=models.CASCADE)
    office              = models.ForeignKey(Office, on_delete=models.CASCADE)
    booking_time        = models.DateTimeField(default=timezone.now)
    location            = models.CharField(max_length=1, choices=LOCATION_OPTIONS)
    class Meta:
            unique_together = ('account', 'booking_time',)

视图逻辑 #

def overview_view(request):

    context = {}

    if request.method == 'GET':
        start_date = None
        end_date = None
        if request.is_ajax():
            booking_times = request.GET.get('day')
            start_date = datetime.strptime(booking_times, "%Y-%m-%d")
            end_date = start_date + timedelta(days=4)
            start_date = start_date.replace(hour=0, minute=0, second=0, microsecond=0, tzinfo=pytz.utc)
            end_date = end_date.replace(hour=0, minute=0, second=0, microsecond=0, tzinfo=pytz.utc)

        context['bookings']=Booking.objects.filter( Q(organization_id=request.user.organization_id), Q(booking_time__range = (start_date, end_date))
        context['office'] = Office.objects.filter(organization_id__exact=request.user.organization_id)
       
        return render(request, 'overview/overview.html', context)
   return render(request, 'overview/overview.html', context)

前端模板 #

<small>{{ office.office_name }}</small>
{% for booking in bookings %}
    <div class="client-item">
        <div class="client-text">
            <p class="name">{{ booking.account.first_name }} {{ booking.account.last_name }}</p>
            {% if booking.get_location_display == 'House' %}
                <p class="sub-title">🏢 {{ booking.get_location_display }}</p>
            {% elif booking.get_location_display == 'Home' %}
                <p class="sub-title">🏠 {{ booking.get_location_display }}</p>
            {% else %}
                <p class="sub-title">🤔 {{ booking.get_location_display }}</p>
            {% endif %}
        </div>
    </div>
{% endfor %}
{% endfor %}

已确认的前置排查结论 #

• 代码中通过字符串解析生成的start_date、end_date均为标准datetime.datetime格式
• 完全删除Q(booking_time__range = (start_date, end_date))筛选条件后，预约数据可正常渲染
• 业务流程要求必须保留日期范围筛选能力，不能直接移除该逻辑

根因定位与修复方案 #

• 空值筛选触发空查询集
  非AJAX请求、或AJAX请求未携带预期day参数时，start_date和end_date始终为None。此时ORM执行booking_time__range=(None, None)的筛选逻辑，会等价于查询booking_time IS NULL的记录，直接返回空结果集，前端自然无法渲染任何数据。
  修复方式：拆分查询集构建逻辑，仅当两个时间参数都为有效值时，再拼接日期筛选条件。示例代码：

  # 修复后的查询集构建逻辑
  booking_qs = Booking.objects.filter(organization_id=request.user.organization_id)
  if start_date and end_date:
      booking_qs = booking_qs.filter(booking_time__range=(start_date, end_date))
  context['bookings'] = booking_qs
  

• 时区不匹配导致筛选范围偏移
  代码中手动给datetime对象硬编码tzinfo=pytz.utc，如果项目开启USE_TZ=True且默认时区不是UTC（例如国内项目通常配置为Asia/Shanghai），手动生成的时间边界会和数据库中存储的时区感知型booking_time存在固定时间差，导致本该落在范围内的预约记录被排除。
  修复方式：替换硬编码时区的写法，使用Django内置时区工具生成匹配项目配置的时间对象：

  from django.utils import timezone
  # 替换手动设置tzinfo的逻辑
  start_date = timezone.make_aware(
      start_date.replace(hour=0, minute=0, second=0, microsecond=0),
      timezone.get_current_timezone()
  )
  end_date = timezone.make_aware(
      end_date.replace(hour=0, minute=0, second=0, microsecond=0),
      timezone.get_current_timezone()
  )
  

• 视图代码语法不闭合
  filter方法调用时，传入第二个Q对象后没有补全右括号，会导致ORM解析筛选条件时出现预期外的逻辑偏差，极端情况下直接抛出字段校验异常，被模板层捕获后返回空渲染。需要补全括号修正语法。
• 模板语法冗余
  模板中{% for booking in bookings %}循环块结束后，多写了一个未匹配的{% endfor %}标签，会触发Django模板语法错误，导致整页渲染直接中断，也是造成页面无内容的可能原因。需要删除冗余的闭合标签。
• 模板分支判断逻辑错位
  模型中定义的位置选项文本为Home Office、Office、Not indicated，但模板中分支判断的匹配值为House、Home，该问题不会导致整个列表渲染为空，但会导致位置标签展示错误，需要修正匹配值和模型定义保持一致。

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