Django实现创建15天后自动删库条目：信号失效求排查及替代方案

核心需求 #

自动删除创建时间距今超过15天的UserHitCount数据库条目（及关联用户），尝试通过Django Signals实现但未生效，需排查代码问题并获取可行方案。

现有代码 #

signals.py

from django.db.models.signals import pre_delete
from django.dispatch import receiver
from django.utils import timezone
from smart_search.models import UserHitCount

@receiver(pre_delete, sender=UserHitCount)
def delete_user_hit_count(sender, instance,** kwargs):
    print("signal handler triggered!")
    if timezone.now() - instance.created_at > timezone.timedelta(minutes=1):
        instance.user.delete()

apps.py

from django.apps import AppConfig

class SmartSearchConfig(AppConfig):
    default_auto_field = 'django.db.models.BigAutoField'
    name = 'smart_search'

    def ready(self):
        from . import signals

init.py

default_app_config = 'smart_app.apps.SmartAppConfig'

models.py

from django.db import models
from user_application.models import Registered_user

class UserHitCount(models.Model):
    user = models.OneToOneField(Registered_user, on_delete=models.CASCADE)
    search_count = models.IntegerField(default=0)
    question_count = models.IntegerField(default=0)
    created_at = models.DateTimeField(auto_now_add=True, null=True)

注：当前信号中判断的是超过1分钟，实际需求是超过15天。

代码问题排查 #

1. 信号类型完全不匹配：pre_delete信号仅在UserHitCount实例被主动删除时触发，无法实现"自动检测过期条目并删除"的需求，逻辑方向错误。
2. App配置路径错误：__init__.py中default_app_config指向smart_app.apps.SmartAppConfig，但实际配置类是smart_search.apps.SmartSearchConfig，路径不匹配会导致信号无法被正确注册。
3. 业务逻辑反向：信号中执行的是删除关联用户，而非删除过期的UserHitCount条目，与需求不符。

可行实现方案 #

方案一：Django定时任务（推荐） #

使用django-crontab实现定时自动清理，这是处理过期数据的标准方案。

步骤：

1. 安装依赖：

pip install django-crontab

2. 在settings.py中添加应用：

INSTALLED_APPS = [
    # ...其他应用
    'django_crontab',
]

3. 在smart_search下创建tasks.py：

from django.utils import timezone
from smart_search.models import UserHitCount

def clean_expired_user_hit_counts():
    cutoff_time = timezone.now() - timezone.timedelta(days=15)
    # 删除过期条目，关联用户会因on_delete=models.CASCADE自动删除
    UserHitCount.objects.filter(created_at__lte=cutoff_time).delete()

4. 在settings.py配置定时规则（每天凌晨2点执行）：

CRONJOBS = [
    ('0 2 * * *', 'smart_search.tasks.clean_expired_user_hit_counts')
]

5. 注册并启动定时任务：

python manage.py crontab add
# 可选：查看已注册任务
python manage.py crontab show

方案二：自定义管理命令 #

创建Django管理命令，手动或通过系统定时任务执行清理。

步骤：

1. 在smart_search下创建目录结构：management/commands/，每个目录需包含空的__init__.py。
2. 创建clean_expired_hits.py：

from django.core.management.base import BaseCommand
from django.utils import timezone
from smart_search.models import UserHitCount

class Command(BaseCommand):
    help = '删除创建时间超过15天的UserHitCount条目及关联用户'

    def handle(self, *args,** options):
        cutoff_time = timezone.now() - timezone.timedelta(days=15)
        count, _ = UserHitCount.objects.filter(created_at__lte=cutoff_time).delete()
        self.stdout.write(self.style.SUCCESS(f'成功删除{count}条过期条目'))

3. 执行清理：

python manage.py clean_expired_hits

后续可通过系统crontab（Linux）或任务计划（Windows）定时执行该命令。

方案三：修正信号逻辑（仅特定场景适用） #

若仅需在创建新条目时清理旧数据，可修正信号配置，但无法实现定时自动清理：

1. 修改signals.py：

from django.db.models.signals import post_save
from django.dispatch import receiver
from django.utils import timezone
from smart_search.models import UserHitCount

@receiver(post_save, sender=UserHitCount)
def clean_expired_on_new_save(sender, instance, created,** kwargs):
    if created:
        cutoff_time = timezone.now() - timezone.timedelta(days=15)
        UserHitCount.objects.filter(created_at__lte=cutoff_time).delete()

2. 修正__init__.py配置：

default_app_config = 'smart_search.apps.SmartSearchConfig'

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