Django添加记录时如何避免重复提交数据？

Question

在Django开发中，如何避免用户重复提交数据是一个常见的技术问题。当用户多次点击提交按钮或网络延迟时，可能导致数据库中出现重复记录。解决这一问题的方法包括：1) 使用唯一约束（unique=True）确保字段值的唯一性；2) 在视图中通过判断POST请求是否已存在来控制提交逻辑；3) 利用前端禁用提交按钮防止多次点击；4) 结合CSRF令牌与一次性标志位验证请求合法性。例如，在模型设计阶段为关键字段添加`unique=True`，配合Django表单验证机制，可有效拦截重复数据。同时，在视图处理时检查记录是否存在再决定是否保存，如`if not Model.objects.filter(field=value).exists(): obj.save()`。这些方法综合运用能显著提升应用的数据完整性和用户体验。

Answer 1

1. 问题概述

在Django开发中，用户重复提交数据是一个常见的技术问题。这种问题通常发生在用户多次点击提交按钮或因网络延迟导致请求被重复发送时。如果处理不当，可能导致数据库中出现重复记录，破坏数据完整性并影响用户体验。

以下是几种常见场景：

• 用户在表单提交后未收到即时反馈，于是再次点击提交按钮。
• 网络不稳定导致浏览器重新发送请求。
• 恶意用户尝试通过脚本进行重复提交。

为解决这些问题，我们需要从模型设计、视图逻辑、前端交互以及安全性验证等多个角度入手。

2. 解决方案分析

以下是从简单到复杂的不同层次解决方案，帮助开发者根据实际需求选择合适的方法。

方法	描述	优点	局限性
使用唯一约束（unique=True）	在模型字段中添加`unique=True`属性，确保字段值的唯一性。	实现简单，直接在数据库层面防止重复。	无法完全避免前端或网络问题引起的重复提交。
视图中检查记录是否存在	在视图处理POST请求时，先检查记录是否已存在再决定是否保存。	灵活性高，可结合业务逻辑定制规则。	可能增加查询开销，需优化性能。
前端禁用提交按钮	在用户点击提交按钮后，立即禁用该按钮以防止多次点击。	提升用户体验，减少重复提交概率。	仅限于前端控制，无法完全阻止恶意行为。
结合CSRF令牌与一次性标志位	通过CSRF令牌和一次性标志位验证请求合法性，确保每个请求只能被执行一次。	安全性高，适用于关键业务场景。	实现复杂度较高，需仔细设计。

3. 综合解决方案示例

以下是一个综合运用多种方法的示例代码，展示如何在Django项目中避免用户重复提交数据。

from django.db import IntegrityError
from django.http import JsonResponse

def submit_form(request):
    if request.method == 'POST':
        value = request.POST.get('field')
        
        # 方法1：视图中检查记录是否存在
        if Model.objects.filter(field=value).exists():
            return JsonResponse({'status': 'error', 'message': 'Record already exists.'})
        
        try:
            # 方法2：模型字段设置 unique=True
            obj = Model(field=value)
            obj.save()
        except IntegrityError:
            return JsonResponse({'status': 'error', 'message': 'Duplicate entry detected.'})
        
        return JsonResponse({'status': 'success', 'message': 'Data saved successfully.'})
    

此外，可以通过前端代码禁用提交按钮：

document.querySelector('form').addEventListener('submit', function() {
    this.querySelector('button[type="submit"]').disabled = true;
});
    

4. 流程图说明

以下是避免重复提交的整体流程图，展示了从前端到后端的完整处理逻辑。