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

作者
ZHOUYI
给博客加搜索联想时,我遇到一个很典型的怪现象:刚输入“Nuxt”,建议正常;继续补成“Nuxt 3”,下拉框却突然跳回旧结果,甚至闪一下空列表。打开 Network 才发现,不是接口坏了,而是先发出的慢请求后返回,把后发出的新结果覆盖了。
先看时序,不要急着怪接口
搜索建议每变一次关键词,就是一次独立请求。用户输入很快,请求会并发。后端查 MongoDB、Redis 或全文索引的耗时稍有波动,响应顺序就可能和输入顺序不一致。前端如果只相信“最后到达的响应”,旧结果就会覆盖新结果,竞态就出现了。
防抖:把连续输入合并成一次请求
第一步是防抖。用户停止输入 200~300 毫秒后再发请求,可以避免每个字符都打到服务端。对 Nuxt 的 SSR 页面和 API 路由来说,这能明显减少无意义查询,也让后面的取消逻辑更容易观察。
- 防抖解决的是请求频率,不解决响应顺序,不能单独根治竞态。
- 间隔太短容易抖动,太长会让建议显得迟钝,我最后选了 250ms。
- 真正发请求前,还要取消上一次未完成的请求,避免旧响应继续飞回来。
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 取消过期请求,请求序号兜底渲染。三者配合,搜索建议才不会拿旧关键词覆盖新结果。”