Django中str类型URL参数触发500错误而非预期404的问题

问题场景 #

当设置URL参数为str类型时，主动访问/del/abc这类不存在的ID会触发500 Internal Server Error，但将参数类型改为int后，访问/del/abc能正常返回404错误。相关代码如下：

项目urls.py #

from django.contrib import admin
from django.urls import path
from todoapp import views

urlpatterns = [
    # admin page
    path('admin/', admin.site.urls),
    # home page
    path('', views.index, name='todo'),
    # delete with item_id
    path('del/<str:item_id>', views.remove, name='del'),
]

handler404 = 'todoapp.views.handling404'

app/views.py #

def remove(request, item_id):
    
    item = get_object_or_404(Todo, id=item_id)
    item.delete()

    messages.info(request, "Item Removed!!!")
    return redirect('todo')

index.html #

<form action="/del/{{item.id}}" method="POST" style="padding-right: 4%; padding-bottom: 3%;">
    {% csrf_token %}
    <button value="Remove" type="submit" class="btn btn-primary" style="float: right;">
        <span class="glyphicon glyphicon-trash">    Remove</span>
    </button>
</form>

疑问：为什么参数为str类型时会返回500错误而非预期的404？

问题根源 #

1. 数据库字段类型不匹配触发未捕获异常
   你的Todo模型id字段默认是AutoField（整数类型），当传入字符串类型的item_id（比如abc）时，get_object_or_404会尝试用字符串去匹配整数类型的数据库字段，这会触发数据库层面的类型转换错误（如MySQL的DataError）。

   Django的get_object_or_404仅捕获模型的DoesNotExist异常并返回404，对于数据库类型不匹配这类底层错误无法处理，最终会向上抛出导致500服务器错误。

2. int类型参数的路由前置过滤
   当URL参数改为<int:item_id>时，Django路由系统会先对请求URL做校验——只有item_id是整数时，才会匹配该路由并进入remove视图。访问/del/abc时，路由系统找不到匹配规则，直接触发404错误，根本不会进入视图执行数据库查询，自然不会出现类型转换问题。

3. 修复方案（若需保留str类型参数）
   如果业务需要使用字符串类型ID（如UUID），可以在视图中先做类型校验，或捕获数据库类型错误并手动返回404：

   from django.http import Http404
   
   def remove(request, item_id):
       try:
           # 若id为整数类型，先尝试转换字符串为整数
           item_id = int(item_id)
           item = get_object_or_404(Todo, id=item_id)
       except ValueError:
           raise Http404("Item does not exist")
       item.delete()
       messages.info(request, "Item Removed!!!")
       return redirect('todo')
   

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