·更新于 2026年11月22日· 35 次浏览 Nuxt 3Vue 3SSRPiniaCookieBUG解决工程实践

Nuxt 3 博客刷新后登录态丢失:我用 Cookie、SSR 注水和白名单稳住用户会话

刷新页面后 Pinia 用户状态被重置,不是 store 写错了,而是 SSR 下状态不能只靠浏览器内存。我用 HttpOnly Cookie 承载会话,在服务端读取 /api/me,再把安全字段注入页面,解决登录态丢失。

Nuxt 3 博客刷新后登录态丢失:我用 Cookie、SSR 注水和白名单稳住用户会话 封面
ZHOUYI

作者

ZHOUYI

前阵子博客评论区有个怪现象:登录后头像和用户名都在,浏览器一刷新,Pinia 里的 user 就空了,页面又变回未登录。第一反应是 store 没持久化,但仔细想,Nuxt 3 是 SSR,服务端每次请求都会新建状态,浏览器里的内存状态也不会天然带到下一次请求。

刷新后 Pinia 为什么会重置

问题不在 Pinia,而在“谁负责恢复登录态”。如果把 token 塞进 localStorage,服务端渲染时读不到;如果把完整用户对象直接写进 Cookie,又容易把敏感字段带到 HTML 里。更稳的方案是:Cookie 只承载会话凭证,服务端校验后返回最小可用用户信息,再由 Nuxt 注水到前端状态。

  1. 登录成功后,后端设置 HttpOnly Cookie,里面只放 sessionId;真实会话可以存 Redis 或 MongoDB,并设置过期时间。
  2. Nuxt 的路由中间件在服务端执行时,用 useRequestHeaders(['cookie']) 带上 Cookie 请求 /api/me,由后端校验会话。
  3. 校验通过后,只取 id、name、avatar、role 这类白名单字段写入 useState,Pinia 或页面组件从同一个状态读取。
ts
export default defineNuxtRouteMiddleware(async () => {
  const user = useState('user', () => null)
  if (user.value) return
  try {
    const res = await $fetch('/api/me', {
      headers: useRequestHeaders(['cookie'])
    })
    const { id, name, avatar, role } = res.user || {}
    user.value = id ? { id, name, avatar, role } : null
  } catch {
    user.value = null
  }
})

几个容易踩的坑

这里有几个坑:Cookie 要按环境配置 Secure、SameSite 和 Domain,本地和线上不一致会直接不携带;用户切换账号或退出时,要同时清掉服务端会话和前端状态;/api/me 过期不要直接弹错,可以返回未登录,让页面降级。最重要的是,别把手机号、邮箱、权限明细这些敏感字段无脑注水,前端展示用什么就取什么。

“SSR 场景下的登录态,不是“前端存一下”,而是服务端验证、最小注水、客户端复用。把 Cookie 当钥匙,把白名单当门,刷新后用户会话才稳。”

Guestbook

留言

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

先确认一下邮箱

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

本文留言

共 0 条已加载 0 条

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