You need to enable JavaScript to run this app. jQuery AJAX词汇掌握标记撤销功能异常:重复点击新增KnownWord记录
优惠活动
大模型
产品
解决方案
定价
更多

jQuery AJAX词汇掌握标记撤销功能异常:重复点击新增KnownWord记录

词汇标记功能产生冗余KnownWord记录的问题排查与修复

核心问题根因

  • get_or_create参数逻辑错误(直接触发冗余的根源)
    Django 的get_or_create方法中,所有传入的位置参数都会作为数据库查询过滤条件,只有defaults字典内的字段会在创建新记录时使用、不参与查询逻辑。
    现有代码把word_is_known=True直接写在查询条件中,实际执行流程为:
    1. 第一次标记已掌握:按「单词+用户+歌曲+word_is_known=True」查询记录,无匹配结果,创建新记录,流程正常
    2. 执行撤销操作:按「单词+用户+歌曲」匹配旧记录,将word_is_known更新为False
    3. 第二次标记已掌握:再次用原条件查询,因为旧记录的word_is_known已经是False,完全匹配不到之前的条目,直接触发新记录创建,最终出现同一单词对应两条不同状态的冗余数据。
  • 前端全局状态脏数据
    前端用全局数组累计存储所有点击、撤销的单词,每次请求都把整个数组传给后端,哪怕单词已经完成状态切换,也会因为数组残留旧值被后端循环处理,进一步放大冗余问题。
  • 缺少数据库层兜底约束
    KnownWord模型未设置唯一约束,代码逻辑出现偏差时,数据库无法拦截重复记录。

对应修复方案

后端逻辑修正

拆分查询条件与创建默认值:查询时仅匹配同一用户、同一内容下的同一个单词,不把word_is_known作为查询过滤条件;如果查到旧记录,直接将状态更新为True,未查到匹配记录时再创建新条目。
修正后的标记接口代码:

def word_known(request, object_pk, pk_user):
    if request.method == 'GET' and request.GET.get('action') == 'add':
        user = request.user
        song = models.Song.objects.get(pk=object_pk)
        # 直接接收单个操作的单词值,不再读取累计数组
        word = request.GET.get('word')
        # 仅用单词、用户、歌曲作为查询条件
        obj, created = models.KnownWord.objects.get_or_create(
            word=word,
            user=user,
            song=song,
            # 仅创建新记录时使用这个默认值,不参与查询
            defaults={'word_is_known': True}
        )
        # 查到旧记录时,主动更新状态为已掌握
        if not created and not obj.word_is_known:
            obj.word_is_known = True
            obj.save(update_fields=['word_is_known'])
        
        return HttpResponse(json.dumps([word]), content_type='application/json')

修正后的撤销接口代码:

def word_known_undo(request, object_pk, pk_user):
    if request.method == 'GET' and request.GET.get('action') == 'remove':
        user = request.user
        song = models.Song.objects.get(pk=object_pk)
        word = request.GET.get('word')
        # 直接更新对应记录的状态为未掌握
        models.KnownWord.objects.filter(
            word=word,
            user=user,
            song=song
        ).update(word_is_known=False)
        
        return HttpResponse(json.dumps([word]), content_type='application/json')

前端逻辑修正

去掉全局累计的单词数组维护,每次点击仅传当前操作的单个单词,增加按钮防重复点击拦截,统一绑定两种状态按钮的点击事件:

$(document).ready(function() {
  // 给标记、撤销两类按钮绑定统一事件
  $(".word_known, .word_known_undo").click(function() {
    const $btn = $(this);
    // 拦截请求过程中的重复点击
    if ($btn.prop('disabled')) return;
    $btn.prop('disabled', true);

    const objectpk = $btn.data('objectpk');
    const userpk = $btn.data('userpk');
    const word = $btn.data('word');
    const isMarked = $btn.hasClass('word_known_undo');

    if (isMarked) {
      // 执行撤销操作
      $.ajax({
        url: `/videos/songs/vocab/known-undo/${objectpk}/${userpk}/`,
        data: {'action': 'remove', 'word': word},
        success: function() {
          $btn.removeClass("word_known_undo btn-success")
              .addClass("word_known btn-warning")
              .text("Yes");
        },
        error: function() {
          alert("There is an error!")
        }
      }).always(() => $btn.prop('disabled', false));
    } else {
      // 执行标记操作
      $.ajax({
        url: `/videos/songs/vocab/known/${objectpk}/${userpk}/`,
        data: {'action': 'add', 'word': word},
        success: function() {
          $btn.removeClass("word_known btn-warning")
              .addClass("word_known_undo btn-success")
              .text("Known");
        },
        error: function() {
          alert("There is an error!")
        }
      }).always(() => $btn.prop('disabled', false));
    }
  });
});

模型层兜底

给KnownWord添加唯一约束,从数据库层面杜绝重复记录产生:

class KnownWord(models.Model):
    word_is_known = models.BooleanField(default=False)
    word = models.CharField(max_length=25)
    user = models.ForeignKey(User, related_name="known_words", on_delete=models.CASCADE)
    song = models.ForeignKey(Song, on_delete=models.CASCADE, null=True, blank=True)
    movie = models.ForeignKey(Movie, on_delete=models.CASCADE, null=True, blank=True)

    class Meta:
        constraints = [
            # 同一用户、同一歌曲下的同一个单词仅允许存在一条记录
            models.UniqueConstraint(
                fields=['user', 'word', 'song'],
                name='uniq_user_song_word'
            ),
            # 同一用户、同一电影下的同一个单词仅允许存在一条记录
            models.UniqueConstraint(
                fields=['user', 'word', 'movie'],
                name='uniq_user_movie_word'
            )
        ]

内容的提问来源于stack exchange,提问作者MeL

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.10 10:15:03