Django-taggit波斯语标签报错：无法匹配post_tag反向解析

问题重现 #

在Django管理后台添加波斯语（Farsi-FA）标签时，模板抛出反向解析错误：

Reverse for 'post_tag' with arguments '('',)' not found. 1 pattern(s) tried: ['tags/(?P<tag_slug>[-a-zA-Z0-9_]+)/\Z']

注：英语及其他拉丁语言标签功能正常

相关代码 #

models.py #

from django.db import models
from taggit.managers import TaggableManager

class Article(models.Model):
    # 其他字段
    tags = TaggableManager()

views.py #

from django.views.generic import ListView

class ArticleTagList(ListView):
    model = Article
    template_name = 'blog/list.html'

    def get_queryset(self):
        return Article.objects.filter(tags__slug=self.kwargs.get('tag_slug'))

urls.py #

from django.urls import path
from .views import ArticleTagList

app_name = 'blog'
urlpatterns = [
    # 其他路由
    path("tags/<slug:tag_slug>/", ArticleTagList.as_view(), name='post_tag'),
]

blog/list.html #

{% for tag in article.tags.all %}
    <a href="{% url 'blog:post_tag' tag.slug %}">{{ tag.name }}</a>
{% endfor %}

已尝试升级django-taggit至3.1.0版本，问题未解决。

解决方案 #

问题核心是django-taggit默认的slug生成逻辑不支持非拉丁字符，导致波斯语标签的slug为空字符串，触发反向解析失败。以下是可行解决方法：

1. 自定义标签模型（推荐） #

创建支持Unicode字符的自定义Tag模型，重写slug生成逻辑：

# 你的app/models.py
from django.db import models
from taggit.models import TagBase, GenericTaggedItemBase
from taggit.managers import TaggableManager
from django.utils.text import slugify

class CustomTag(TagBase):
    class Meta:
        verbose_name = "标签"
        verbose_name_plural = "标签"

    def save(self, *args, **kwargs):
        # 生成支持Unicode的slug
        if not self.slug:
            self.slug = slugify(self.name, allow_unicode=True)
        super().save(*args, **kwargs)

class TaggedArticle(GenericTaggedItemBase):
    tag = models.ForeignKey(CustomTag, on_delete=models.CASCADE, related_name="tagged_articles")

class Article(models.Model):
    # 其他字段
    tags = TaggableManager(through=TaggedArticle)

同时在项目settings.py中开启Unicode slug支持：

ALLOW_UNICODE_SLUGS = True

2. 修改URL路径转换器 #

如果不想自定义标签模型，可先修改URL规则，让路径支持非拉丁字符：

# urls.py
urlpatterns = [
    # 替换原路由为str转换器
    path("tags/<str:tag_slug>/", ArticleTagList.as_view(), name='post_tag'),
]

注意：此方法需配合方案1中的slug生成逻辑使用，否则波斯语标签仍会生成空slug

3. 第三方库增强slug生成 #

使用python-slugify库处理多语言slug：

pip install python-slugify

修改自定义Tag模型的save方法：

from slugify import slugify

class CustomTag(TagBase):
    # ...
    def save(self, *args, **kwargs):
        if not self.slug:
            self.slug = slugify(self.name, lowercase=False)
        super().save(*args, **kwargs)

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