如何在Django Admin站点实现slug字段自动更新

问题根因 #

现有自动填充Slug的逻辑通常仅针对新建对象触发：判断对象无数据库主键时生成对应Slug，编辑场景下默认不覆盖已有Slug，避免已发布文章的URL发生非预期变更，因此会出现修改标题时Slug不同步更新的情况。 #

具体实现方案 #

方案1：在Model的save方法中扩展更新逻辑

直接在文章模型的保存逻辑中增加标题变更检测，所有调用模型保存的入口（Admin、接口、脚本）都会生效。
修改后的模型代码示例：

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

class Article(models.Model):
    title = models.CharField(max_length=200, verbose_name="文章标题")
    slug = models.SlugField(
        max_length=200,
        unique=True,
        allow_unicode=True,
        verbose_name="URL别名"
    )

    def save(self, *args, **kwargs):
        # 新建对象直接生成初始Slug
        if not self.pk:
            self.slug = slugify(self.title, allow_unicode=True)
        else:
            # 编辑场景：拉取数据库中存储的旧标题做对比
            old_article = Article.objects.get(pk=self.pk)
            # 检测到标题变更时，重新生成对应Slug
            if self.title != old_article.title:
                self.slug = slugify(self.title, allow_unicode=True)
        super().save(*args, **kwargs)

注意：如果存在Slug重名的情况，需要补充后缀循环逻辑确保值唯一，避免触发数据库唯一约束报错。

方案2：在Admin层通过save_model钩子实现逻辑

该方式仅在Admin站点的保存流程中生效，不会影响其他业务入口的Slug生成规则，更适配仅通过Admin管理内容的使用场景。
在应用的admin.py中编写对应注册逻辑：

from django.contrib import admin
from django.utils.text import slugify
from .models import Article

@admin.register(Article)
class ArticleAdmin(admin.ModelAdmin):
    list_display = ("title", "slug", "publish_status")

    def save_model(self, request, obj, form, change):
        # change参数为True时代表当前操作是编辑已有文章
        if change:
            old_title = Article.objects.get(pk=obj.pk).title
            # 标题发生变更时同步刷新Slug值
            if obj.title != old_title:
                obj.slug = slugify(obj.title, allow_unicode=True)
        super().save_model(request, obj, form, change)

方案3：增加手动控制开关，适配SEO场景

如果担心修改已发布文章的标题时Slug变更导致旧链接失效，可以在Admin表单中增加勾选选项，让发布者自行决定是否同步更新Slug。
扩展后的Admin代码示例：

from django import forms
from django.contrib import admin
from django.utils.text import slugify
from .models import Article

class ArticleAdminForm(forms.ModelForm):
    sync_slug = forms.BooleanField(
        label="修改标题时同步更新Slug",
        initial=True,
        required=False,
        help_text="文章发布后建议取消勾选，避免旧访问链接失效"
    )

    class Meta:
        model = Article
        fields = "__all__"

@admin.register(Article)
class ArticleAdmin(admin.ModelAdmin):
    form = ArticleAdminForm

    def save_model(self, request, obj, form, change):
        if change and form.cleaned_data.get("sync_slug"):
            old_title = Article.objects.get(pk=obj.pk).title
            if obj.title != old_title:
                obj.slug = slugify(obj.title, allow_unicode=True)
        super().save_model(request, obj, form, change)

关键注意事项 #

• 中文标题生成Slug时必须开启allow_unicode=True参数，否则会生成空值Slug
• 可补充逻辑判断：仅当文章为草稿状态时自动更新Slug，已发布的文章默认不覆盖原有Slug，减少对SEO的影响
• 生成新Slug时需要处理重名场景，比如对重复值追加自增数字后缀，确保字段满足唯一约束

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