DRF序列化器中pre_save方法的使用及slug生成报错解决

首先，你遇到的name 'create_slug' is not defined错误，大概率是信号接收器的作用域问题——当pre_save信号触发时，Django找不到create_slug函数。这通常是因为信号代码所在的文件未被Django正确加载，或者函数定义在局部作用域里。不过更推荐的是把slug生成逻辑移到更可控的位置，下面是几种方案和最佳实践：

1. 首选：在模型的save方法中处理（最统一的方案） #

把slug生成逻辑直接放到Article模型的save方法里，这样不管是通过Django Admin、DRF API还是其他方式创建/更新实例，都会自动触发slug生成，逻辑统一且易于维护。

修改你的Article模型代码：

from django.db import models
from django.utils.text import slugify

class Article(models.Model):
    title = models.CharField(max_length=255)
    slug = models.SlugField(unique=True, blank=True)
    user = models.ForeignKey(User, on_delete=models.CASCADE)  # 假设你关联了User模型
    content = models.TextField()
    excerpt = models.TextField()

    def _create_slug(self, new_slug=None):
        # 用下划线开头标记为内部方法
        slug = slugify(self.title)
        if new_slug is not None:
            slug = new_slug
        # 排除当前实例本身，避免更新时和自己冲突
        qs = Article.objects.filter(slug=slug).exclude(id=self.id).order_by("-id")
        exists = qs.exists()
        if exists:
            new_slug = f"{slug}-{qs.first().id}"
            return self._create_slug(new_slug=new_slug)
        return slug

    def save(self, *args, **kwargs):
        # 新建时生成slug
        if not self.slug:
            self.slug = self._create_slug()
        # 可选：如果更新时标题修改了，重新生成slug
        # 先记录原始标题（需要在__init__里初始化）
        # if self.title != self._original_title:
        #     self.slug = self._create_slug()
        super().save(*args, **kwargs)

    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        # 保存原始标题，用于更新时对比
        self._original_title = self.title

这种方案的优势：

• 逻辑集中在模型层，所有操作模型的场景都能覆盖
• 避免信号带来的隐式依赖和加载顺序问题
• 调试和维护更直观

2. 次选：在DRF序列化器中重写create/update方法 #

如果只需要在API层面处理slug生成，可以在序列化器中重写对应的方法。这种方式适合有特定API逻辑的场景，但缺点是Django Admin等其他渠道创建的实例不会触发slug生成。

修改你的序列化器：

from rest_framework import serializers
from yogavidya.apps.articles.models import Article
from django.utils.text import slugify

class ArticleSerializer(serializers.ModelSerializer):
    class Meta:
        model = Article
        fields = ["title", "user", "content", "excerpt", "slug"]  # 包含slug字段，可设为read_only=True

    def _create_slug(self, instance, new_slug=None):
        slug = slugify(instance.title)
        if new_slug is not None:
            slug = new_slug
        qs = Article.objects.filter(slug=slug).exclude(id=instance.id).order_by("-id")
        exists = qs.exists()
        if exists:
            new_slug = f"{slug}-{qs.first().id}"
            return self._create_slug(instance, new_slug=new_slug)
        return slug

    def create(self, validated_data):
        instance = Article(**validated_data)
        if not instance.slug:
            instance.slug = self._create_slug(instance)
        instance.save()
        return instance

    def update(self, instance, validated_data):
        # 如果标题被修改，重新生成slug
        new_title = validated_data.get("title", instance.title)
        if new_title != instance.title:
            instance.slug = self._create_slug(instance)
        # 更新其他字段
        return super().update(instance, validated_data)

3. 修复原信号方案（不推荐） #

如果你坚持使用信号，需要确保：

• create_slug函数和信号接收器在同一个文件中，且为全局定义
• 信号所在的文件被Django正确加载：如果信号代码在单独的signals.py文件中，需要在apps.py的ready方法中导入：

# yogavidya/apps/articles/apps.py
from django.apps import AppConfig

class ArticlesConfig(AppConfig):
    default_auto_field = 'django.db.models.BigAutoField'
    name = 'yogavidya.apps.articles'

    def ready(self):
        # 导入信号文件，确保Django加载它
        import yogavidya.apps.articles.signals

同时检查函数名拼写是否正确，没有大小写错误等。

总结最佳位置 #

• 模型的save方法：是最推荐的方案，逻辑统一，覆盖所有场景，避免隐式问题
• DRF序列化器：适合仅API层面需要特殊处理的场景
• 信号：尽量避免，因为信号是隐式逻辑，调试和维护成本高，容易出现作用域、加载顺序等问题

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