Django中URL反向解析失败：task_list_by_tag无法匹配参数

出现错误：

Reverse for 'task_list_by_tag' with arguments '('оаип_1',)' not found. 1 pattern(s) tried: ['tag/(?P<tag_slug>[-a-zA-Z0-9_]+)/\Z']

相关代码如下：

views.py

def index(request, tag_slug=None):
    task_list = Task.objects.all()
    
    tag = None

    if tag_slug:
        tag = get_object_or_404(Tag, slug=tag_slug)
        task_list = task_list.filter(tags__in=[tag])

    paginator = Paginator(task_list, 2)
    page_number = request.GET.get('page', 1)
    try:
        tasks = paginator.page(page_number)

    context = {"tasks":tasks, 'tag':tag}

    return render(request, 'main/index.html', context)

urls.py

app_name = 'main'
...
path('tag/<slug:tag_slug>/', views.index, name = "task_list_by_tag"),

index.html

{% for tag in task.tags.all %}
       <a href="{% url "main:task_list_by_tag" tag.slug %}">
           {{ tag.name }}
       </a>
{% if not forloop.last %}, {% endif %}
{% endfor %}

尝试过两种修复方法，均未解决：

1. 使用关键字参数传递slug：

<a href="{% url "main:task_list_by_tag" tag_slug=tag.slug %}">

返回错误：

Reverse for 'task_list_by_tag' with keyword arguments '{'tag_slug': 'оаип_1'}' not found. 1 pattern(s) tried: ['tag/(?P<tag_slug>[-a-zA-Z0-9_]+)/\Z']

2. 错误使用参数名slug：

<a href="{% url "main:task_list_by_tag" slug=tag.slug %}">

返回错误：

Reverse for 'task_list_by_tag' with keyword arguments '{'slug': 'оаип_1'}' not found. 1 pattern(s) tried: ['tag/(?P<tag_slug>[-a-zA-Z0-9_]+)/\Z']

解决方案 #

问题根源在于Django默认的slug路径转换器只匹配[-a-zA-Z0-9_]范围的字符，而你的tag slug包含俄文字符（оаип_1），不符合正则规则，导致反向解析失败。以下两种方案可解决：

方案1：替换为str路径转换器

直接将urls中的slug转换器改为str，str转换器支持任意非空字符串（不含斜杠），自然兼容俄文字符：

# urls.py
app_name = 'main'
...
path('tag/<str:tag_slug>/', views.index, name="task_list_by_tag"),

方案2：自定义支持Unicode的slug转换器

如果需要保留slug的格式约束但支持俄文等Unicode字符，可自定义路径转换器：

1. 在app目录下创建converters.py，添加以下代码：

from django.urls.converters import SlugConverter
from django.utils.regex_helper import _lazy_re_compile

class UnicodeSlugConverter(SlugConverter):
    # 正则添加俄文字符范围，可根据需要扩展其他语言字符
    regex = r'[-a-zA-Z0-9_а-яА-Я]+'

2. 在urls.py中注册并使用自定义转换器：

# urls.py
from django.urls import register_converter
from .converters import UnicodeSlugConverter

register_converter(UnicodeSlugConverter, 'unicode_slug')

app_name = 'main'
...
path('tag/<unicode_slug:tag_slug>/', views.index, name="task_list_by_tag"),

额外注意

确保Tag模型生成slug时使用支持Unicode的slugify方法，比如使用django.utils.text.slugify并设置allow_unicode=True：

from django.utils.text import slugify

class Tag(models.Model):
    name = models.CharField(max_length=100)
    slug = models.SlugField(max_length=100, unique=True)

    def save(self, *args, **kwargs):
        if not self.slug:
            self.slug = slugify(self.name, allow_unicode=True)
        super().save(*args, **kwargs)

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