Next.js 应用程序路由器和 SSR 指南
将 Aurabase 集成到带有服务器组件、服务器操作、中间件和安全会话的 Next.js 14/15 App Router 应用程序的分步架构指南。
10分钟 读取·级别 中间·修改于 2026年8月19日
该英文文本是根据法文原文自动生成的,尚未经过审查。
该页面已自动翻译。英文版具有权威性。
#
建筑
Aurabase SSR 模型
在现代服务器端渲染的应用程序中,用户的身份验证状态无法存储在浏览器的 localStorage 中(服务器无法访问)。 Aurabase 自动同步安全 HTTP cookie 中的会话。
完全查询隔离
createServerClient 在内存中没有共享状态。每个服务器请求都会实例化一个连接到请求的 HTTP 标头的隔离客户端,保证用户之间的绝对紧密性(会话泄漏的风险为零)。
#
实施
应用路由器的三大支柱
Web 浏览器将 cookie 的大小限制为大约 4 KB。当 JWT 令牌或用户元数据超过此限制时,@aurabase/aurabase-js/ssr 模块会自动将负载拆分为多个编号的 cookie:
aura-[project_id]-auth.0(前 3600 字节)aura-[project_id]-auth.1(会议剩余时间)
读取后,服务器忠实地重新组装块以恢复状态,而不会丢失任何数据或会话中断。
#
安全性
生产黄金法则
HttpOnly 和 SameSite 属性
刷新令牌 cookie 决不应该暴露给客户端 JavaScript,以防止 XSS 攻击。
Role Key 服务严格服务器
切勿将 SERVICE_ROLE_KEY 传递到 createBrowserClient 或带有“use client”指令的组件中。
中间件刷新
始终在中间件中调用 getSession() 或 getUser() 在令牌过期之前更新令牌。
#
继续
为了走得更远
最后更新· 2026年8月19日