Next.js 安全
优先级:P0(关键)
结构
app/
├── lib/
│ └── validation.ts # 共享 Zod 模式
└── middleware.ts # 身份验证和头部
实施指南
- Next.js 中间件:使用
middleware.ts 进行边缘端身份验证、基于角色的访问控制 (RBAC) 并强制执行 安全头部(例如 Content-Security-Policy (CSP)、X-XSS-Protection)。
- Server Actions:始终使用 Zod 对来自
FormData 或 JSON 的 所有输入进行消毒。在每个操作内部执行 身份验证检查(await auth())以验证调用者。
- 数据污染:使用
experimental_taint API(taintObjectReference)确保敏感服务器对象(例如包含 passwordHash 的 User)永远不会泄露到客户端组件中。
- 路由处理器 (
route.ts):实施 速率限制 以防止暴力破解或 DoS 攻击。验证 Origin/Referer 头部 以缓解 CSRF(跨站请求伪造)。
- 身份验证令牌:严格使用
HttpOnly、Secure Cookie 以及 SameSite: 'Lax' 进行会话管理。切勿将令牌存储在 localStorage 中。
- 逻辑隔离:使用
server-only 包防止后端特定逻辑被包含在客户端包中。
- 组件纯化:转义组件中渲染的所有用户提供的内容。切勿在没有消毒器(如
DOMPurify)的情况下使用 dangerouslySetInnerHTML。
反模式
- 不要将数据库字段泄露给客户端:使用 DTO;切勿传递原始模型对象。
- 不要在客户端包中使用
process.env:仅当安全暴露时,才将其标记为 NEXT_PUBLIC_。
- 不要使用未经验证的 Server Action 输入:始终使用 Zod 模式进行验证。
- 不要在共享布局中进行身份验证检查:在布局中进行身份验证是不安全的;请使用中间件。
参考