jQuery AJAX词汇掌握标记撤销功能异常:重复点击新增KnownWord记录
词汇标记功能产生冗余KnownWord记录的问题排查与修复
核心问题根因
get_or_create参数逻辑错误(直接触发冗余的根源)
Django 的get_or_create方法中,所有传入的位置参数都会作为数据库查询过滤条件,只有defaults字典内的字段会在创建新记录时使用、不参与查询逻辑。
现有代码把word_is_known=True直接写在查询条件中,实际执行流程为:- 第一次标记已掌握:按「单词+用户+歌曲+word_is_known=True」查询记录,无匹配结果,创建新记录,流程正常
- 执行撤销操作:按「单词+用户+歌曲」匹配旧记录,将
word_is_known更新为False - 第二次标记已掌握:再次用原条件查询,因为旧记录的
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
相关产品推荐
相关产品推荐

