·更新于 2026年11月15日· 36 次浏览 Nuxt 3Vue 3搜索建议竞态BUG解决工程实践

Nuxt 3 搜索建议被旧结果覆盖?我用防抖、取消请求和序号修好竞态

搜索联想接口如果返回顺序不稳定,旧关键词的结果可能覆盖新结果。这篇记录我在 Nuxt 3 里用防抖、AbortController 和请求序号修复竞态的过程。

Nuxt 3 搜索建议被旧结果覆盖?我用防抖、取消请求和序号修好竞态 封面
ZHOUYI

作者

ZHOUYI

给博客加搜索联想时,我遇到一个很典型的怪现象:刚输入“Nuxt”,建议正常;继续补成“Nuxt 3”,下拉框却突然跳回旧结果,甚至闪一下空列表。打开 Network 才发现,不是接口坏了,而是先发出的慢请求后返回,把后发出的新结果覆盖了。

先看时序,不要急着怪接口

搜索建议每变一次关键词,就是一次独立请求。用户输入很快,请求会并发。后端查 MongoDB、Redis 或全文索引的耗时稍有波动,响应顺序就可能和输入顺序不一致。前端如果只相信“最后到达的响应”,旧结果就会覆盖新结果,竞态就出现了。

防抖:把连续输入合并成一次请求

第一步是防抖。用户停止输入 200~300 毫秒后再发请求,可以避免每个字符都打到服务端。对 Nuxt 的 SSR 页面和 API 路由来说,这能明显减少无意义查询,也让后面的取消逻辑更容易观察。

  • 防抖解决的是请求频率,不解决响应顺序,不能单独根治竞态。
  • 间隔太短容易抖动,太长会让建议显得迟钝,我最后选了 250ms。
  • 真正发请求前,还要取消上一次未完成的请求,避免旧响应继续飞回来。
ts
const keyword = ref('')
const suggestions = ref([])
let timer, ctrl, seq = 0
watch(keyword, (q) => {
  clearTimeout(timer)
  ctrl?.abort()
  timer = setTimeout(async () => {
    const id = ++seq
    const ac = ctrl = new AbortController()
    try {
      const data = await $fetch('/api/suggest', { params: { q }, signal: ac.signal })
      if (id === seq) suggestions.value = data
    } catch (e) { if (!ac.signal.aborted) console.error(e) }
  }, 250)
})

AbortController:过期请求直接取消

每次进入真正的请求逻辑前,我会先 abort 上一次的 controller。这样浏览器会中断 fetch;如果 Node.js 中间层把 signal 透传给下游查询,也能尽早停止数据库或缓存请求。它的好处不只是前端不渲染,还能减少服务端白跑一次。

请求序号:响应到达时再校验一次

取消也不是万无一失。有些代理、缓存或网关可能不完全配合,响应可能已经进入浏览器队列。所以我给每次请求加了序号:发请求前 seq 自增,回来时对比 current === seq。只要不是最新一次,就直接丢弃,不做赋值,也不弹错误提示。

“防抖降低频率,AbortController 取消过期请求,请求序号兜底渲染。三者配合,搜索建议才不会拿旧关键词覆盖新结果。”

Guestbook

留言

若这篇文章也曾停在你心上,留一行字吧,我会看的。

先确认一下邮箱

多这一步,是为了少些机器骚扰,也让我能更踏实地读每一条真人写下的字。验证码 10 分钟内有效;同一邮箱 60 秒内只能发一封。

本文留言

共 0 条已加载 0 条

这里还静悄悄的——愿意做第一个留下脚印的人吗?