ssr中cookie只能由服务端从请求头解析，node.js无法使用document.cookie；express需cookie-parser中间件，next.js推荐nookies库在getserversideprops中解析；httponly cookie前端不可读，须服务端校验并注入props。
在服务端渲染（SSR）中，JavaScript 无法直接读取 Cookie，因为 Node.js 环境没有 document.cookie。真正能读取 Cookie 的是服务端（如 Express、Next.js API 路由、Nuxt 服务端逻辑），而“在 SSR 中读取 Cookie”本质是：在服务端请求上下文中解析 HTTP 请求头里的 Cookie 字段。
服务端需从请求头中手动解析 Cookie
浏览器发起页面请求时，会自动把匹配域名和路径的 Cookie 通过 Cookie 请求头发送给服务器（例如 Cookie: auth_token=abc123; theme=dark）。Node.js 服务端需要主动提取并解析这个字符串。
- Express 中可借助
cookie-parser中间件：app.use(cookieParser());<br>app.get('/', (req, res) => {<br> console.log(req.cookies.auth_token); // 直接获取解析后的对象<br>}); - 无中间件时可手动解析（简单场景）：
const cookies = Object.fromEntries(<br> req.headers.cookie?.split('; ').map(c => c.split('=')) || []<br>);<br>// 注意：未解码，含空格/特殊字符需用 decodeURIComponent
Next.js SSR 中读取 Cookie 的正确方式
在 getServerSideProps 中，通过 context.req.headers.cookie 获取原始 Cookie 字符串，推荐使用 nookies 库统一处理：
- 安装：
npm install nookies - 使用：
import { parseCookies } from 'nookies';<br>export async function getServerSideProps(context) {<br> const cookies = parseCookies(context);<br> const token = cookies.auth_token;<br> return { props: { token } };<br>} -
nookies.parseCookies自动处理decodeURIComponent和分号分割，比手写更安全
注意同构代码中的常见误区
不要在组件顶层或 useEffect 中尝试用 document.cookie “同步” SSR 数据 —— 它在服务端执行时报错，且客户端读到的是初始 HTML 渲染后才有的值，与服务端不一致。
- 服务端数据必须在
getServerSideProps/asyncData/load等服务端钩子中获取 - 客户端后续更新可用
document.cookie，但不应依赖它补全 SSR 缺失的状态 - 敏感 Cookie（如认证 token）务必设
HttpOnly: true，此时前端 JS 根本读不到，只能靠服务端转发验证结果
Cookie 与身份验证结合的典型流程
以登录态为例，SSR 页面需服务端校验用户是否已登录，不能等前端加载完再发请求：
- 客户端登录成功后，后端 set-cookie 返回
auth_token=xxx; HttpOnly; Secure; SameSite=Lax - 下次页面请求，服务端从
req.headers.cookie提取auth_token，查 Redis 或 JWT 解析 - 验证通过后，将用户信息注入
props，组件直接渲染用户昵称、权限按钮等 - 避免“先渲染游客版，再闪动为登录版”，提升体验与 SEO
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
