Nuxt 3 列表页切筛选偶发旧数据:我用稳定 useAsyncData key 修好串缓存
筛选列表切换后偶尔显示旧数据,接口却是新的。根因是 useAsyncData 的缓存 key 太粗,不同筛选条件共享了同一份缓存。我用参数排序生成稳定 key,再配合依赖追踪和定向刷新,把缓存边界收准。

作者
ZHOUYI
这个问题表现得很隐蔽:从列表页切分类、标签或页码时,大多数时候正常,偶尔会闪一下旧列表。接口日志里返回的是新数据,页面却渲染了上一次的结果。最初我以为是请求竞态或者 Vue 响应式没更新,后来发现真正的问题在 useAsyncData 的缓存 key。
旧数据为什么会串
之前 key 直接写成固定字符串,或者只取 route.path。列表页路径不变,筛选条件放在 query 里,于是不同条件都会命中同一份缓存。还有两个坑:query 顺序不稳定,同样条件可能生成不同字符串;时间戳、来源埋点这类无关参数混进 key,又会让缓存命中率变差。最终表现就是:某次筛选请求成功后,数据被写进公共 key,下一次切换条件时又把它读出来。
把筛选参数变成稳定指纹
- 只收集影响接口结果的字段,例如 page、tag、sort。
- 对字段名排序后拼接,避免 query 顺序造成差异。
- 去掉埋点、时间戳等无关参数,防止缓存被污染。
- 把这个指纹作为 useAsyncData 的 key,并监听真正影响请求的依赖。具体动态 key 写法以官方文档为准。
// key 生成思路;动态 key 用法以官方文档为准
function stableKey(prefix, params) {
const qs = Object.keys(params).sort().map(k => `${k}=${params[k] ?? ''}`).join('&')
return `${prefix}:${qs}`
}
const filters = computed(() => ({ page: route.query.page || 1, tag: route.query.tag || '' }))
const key = computed(() => stableKey('list', filters.value))
await useAsyncData(key, () => fetchList(filters.value), { watch: [filters] })
定向失效,别一键清掉全部
修完 key 后,我没有再做全量清缓存。数据变更时,只刷新当前筛选指纹对应的 key;如果多个筛选组合需要更新,就维护一组明确的 key。这样既能避免旧数据残留,也不会把正常缓存打穿。踩坑点有两个:切换筛选类型时要同步重置页码,否则第 5 页加新筛选可能请求到空结果;监听依赖别把无关对象放进去,不然会重复触发请求。
“缓存问题的关键通常不是有没有缓存,而是缓存边界是否和请求参数一一对应。”
最后的效果是列表切换稳定了很多:相同筛选快速返回,不同筛选不再串数据,失效也能精确到页面。对 SEO 和用户体验来说,少一次旧数据闪现,就少一次用户误点。