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

作者
ZHOUYI
前阵子博客评论区有个怪现象:登录后头像和用户名都在,浏览器一刷新,Pinia 里的 user 就空了,页面又变回未登录。第一反应是 store 没持久化,但仔细想,Nuxt 3 是 SSR,服务端每次请求都会新建状态,浏览器里的内存状态也不会天然带到下一次请求。
刷新后 Pinia 为什么会重置
问题不在 Pinia,而在“谁负责恢复登录态”。如果把 token 塞进 localStorage,服务端渲染时读不到;如果把完整用户对象直接写进 Cookie,又容易把敏感字段带到 HTML 里。更稳的方案是:Cookie 只承载会话凭证,服务端校验后返回最小可用用户信息,再由 Nuxt 注水到前端状态。
用 Cookie 做会话,用 useState 做注水
- 登录成功后,后端设置 HttpOnly Cookie,里面只放 sessionId;真实会话可以存 Redis 或 MongoDB,并设置过期时间。
- Nuxt 的路由中间件在服务端执行时,用 useRequestHeaders(['cookie']) 带上 Cookie 请求 /api/me,由后端校验会话。
- 校验通过后,只取 id、name、avatar、role 这类白名单字段写入 useState,Pinia 或页面组件从同一个状态读取。
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 当钥匙,把白名单当门,刷新后用户会话才稳。”