Next.js 代理安全边界重构:从 CVE-2025-29927 看 proxy.ts 重命名背后的鉴权陷阱与纵深防御

【Next.js 代理安全边界】CVE-2025-29927 高危漏洞警示:Next.js 16 将 middleware 重命名为 proxy 并非表面改动,而是安全边界的重新定义。本文深度剖析代理层误用为鉴权层的致命风险,提供从 Proxy 到数据访问层(DAL)的架构迁移方案,并给出可落地...

导语:Next.js 代理安全边界在 16 版本中因 middleware 到 proxy 的重命名而被重新定义,这绝非一次简单的 API 更名,而是对开发者的一次严肃安全警示。结合 CVE-2025-29927 高危漏洞,我们必须重新审视将代理层作为唯一鉴权点的架构风险,并构建基于数据访问层(DAL)的纵深防御体系。

🎯 核心技术Next.js 16 Proxy / DAL
⚡ 架构难度资深架构级 (Level 3-4)
🚀 核心收益消除单点鉴权风险,提升安全水位
📐 Next.js 代理安全边界与纵深防御架构全景
企业级架构规范

flowchart TD
    subgraph 接入层 ["表现层与接入网关 (Client & Gateway Tier)"]
        A["客户端请求 (HTTP)"] --> B["Proxy 层 (proxy.ts)
仅做路由/重定向/Header 设置"] end subgraph 应用层 ["应用服务与路由层 (Application Tier)"] B --> C["页面组件 / Server Actions"] end subgraph 数据层 ["数据访问与鉴权层 (Data Access Tier)"] C --> D["verifySession() 数据访问层 (DAL)
每次数据读写前校验"] D --> E["数据库 / 外部服务"] end subgraph 安全边界 ["安全控制点"] B -.->|不可作为唯一鉴权点| F["⚠️ 单点失效风险"] D --> G["✅ 纵深防御"] end
图 1: Next.js 代理安全边界与纵深防御架构,展示 Proxy 仅处理请求级决策,而鉴权下沉至数据访问层,形成多道防线。

一、事件背景:CVE-2025-29927 与 proxy.ts 重命名

2025 年 3 月,Next.js 曝出 CVE-2025-29927 高危漏洞(CVSS 9.1),攻击者可通过构造 x-middleware-subrequest 请求头绕过中间件,直接访问受保护路由。该漏洞的根源在于:许多应用将中间件作为唯一的鉴权屏障。无独有偶,Next.js 16 将 middleware.ts 重命名为 proxy.ts,官方文档明确表示旧名称误导开发者将其视为 Express 中间件,并建议“作为最后手段使用”。这并非表面更名,而是对代理层职责的重新定位——它应是网络边界,而非业务逻辑容器。

🚨 严重隐患告警

CVE-2025-29927 表明,任何仅依赖中间件进行鉴权的应用,在漏洞版本下可被完全绕过。若你的应用仍将 session 校验放在 proxy 中,请立即迁移至数据访问层。

二、proxy.ts 重命名背后的运行时与职责变化

2.1 运行时默认切换至 Node.js

Next.js 16 中,Proxy 默认运行在 Node.js 运行时,且无法通过 export const runtime 切换至 Edge。这意味着你可以使用完整的 Node.js 标准库和任意 npm 包,但同时也消除了以往 Edge 运行时对数据库连接等操作的天然限制。摩擦的消失反而增加了误用风险——开发者更容易在 Proxy 中执行数据库查询或复杂逻辑。

2.2 官方定位:Proxy 是网络边界,而非应用逻辑层

Next.js 文档强调,Proxy 应仅用于基于请求的轻量决策:重定向、重写、设置请求/响应头、以及乐观的 cookie 存在性检查。任何需要查询数据库或加密验证 token 的逻辑,都应移至数据访问层(DAL)。

💡 架构核心决策

将 Proxy 视为“请求预处理层”,而非“安全控制层”。安全校验必须发生在数据被读取或写入的瞬间,即数据访问层。

三、常见反模式:将 Proxy 作为鉴权层

以下代码展示了一个典型的错误模式:在 proxy 中直接查询数据库并校验 session。

// proxy.ts: 反模式 - 将鉴权逻辑放在 Proxy 中
export async function proxy(request: NextRequest) {
  const session = await db.session.findUnique({
    where: { token: request.cookies.get("session")?.value },
  });
  if (!session) {
    return NextResponse.redirect(new URL("/login", request.url));
  }
}

该模式存在三大问题:

  • 性能损耗:每个匹配的请求(包括预取)都会触发数据库查询,增加延迟。
  • 部署耦合:Proxy 可能独立部署,共享模块或全局状态(如数据库连接池)不可靠。
  • 单点失效:一旦 matcher 配置遗漏或漏洞绕过,鉴权完全失效。CVE-2025-29927 正是此类风险的现实例证。
⚠️ 生产避坑风险

Server Functions 并非独立路由,而是对页面路径的 POST 请求。若 matcher 排除该路径,Proxy 不会执行,鉴权静默失效。因此,绝不能将鉴权唯一寄托于 Proxy。

四、纵深防御:将鉴权下沉至数据访问层(DAL)

正确的做法是在每个页面和 Server Action 中调用数据访问层的 verifySession 函数,确保每次数据读写前都进行校验。利用 React 的 cache 函数可对同一渲染周期内的重复调用去重,避免性能损失。

4.1 实现数据访问层(DAL)

import "server-only";
import { cache } from "react";
import { cookies } from "next/headers";
import { redirect } from "next/navigation";
import { getSessionFromDb } from "./sessions";

export const verifySession = cache(async () => {
  const token = (await cookies()).get("session")?.value;
  const session = token ? await getSessionFromDb(token) : null;
  if (!session) redirect("/login");
  return session;
});

4.2 在 Server Action 中调用

"use server";
import { verifySession } from "./lib/dal";
import { db } from "./lib/db";

export async function deleteProject(id: string) {
  const session = await verifySession();
  await db.project.delete({ where: { id, ownerId: session.userId } });
}

通过这种方式,每个数据操作都自带鉴权,无论 Proxy 的 matcher 如何配置,安全边界始终稳固。

💡 架构核心决策

将鉴权逻辑集中到 DAL,并通过 cache 去重,既保证安全又避免性能退化。这是 Next.js 官方推荐的数据安全最佳实践。

五、Proxy 的合理用途与配置要点

Proxy 仍适用于以下场景:

  • 基于路径、语言或特性标志的重定向与重写。
  • 乐观的鉴权检查:仅检查 session cookie 是否存在,若不存在则提前重定向至登录页(UX 优化,非安全边界)。
  • 设置请求/响应头(如 CORS、请求 ID、安全头)。
  • 使用 event.waitUntil() 进行非阻塞日志记录。

配置 matcher 时需注意:未配置 matcher 时 Proxy 会匹配所有请求,包括 _next/static 和 public/ 下的文件,可能导致重定向错误阻塞静态资源。即使通过负向 matcher 排除 _next/data,Proxy 仍会为这些路由执行,这是有意设计,防止遗漏数据路由的保护。

export const config = { matcher: [“/((?!_next/static|_next/image|favicon.ico).*)”] }JS

六、迁移检查清单与总结

若你已升级至 Next.js 16,请按以下步骤重构:

  1. 运行 codemod 重命名文件与函数:npx @next/codemod@canary middleware-to-proxy .
  2. 审查 proxy.ts,移除所有数据库查询和复杂鉴权逻辑。
  3. 将 session 校验迁移至数据访问层(DAL),并在每个页面和 Server Action 中调用。
  4. 确保 Proxy 仅保留重定向、重写、Header 设置和乐观 cookie 检查。
  5. 为 DAL 编写单元测试,验证鉴权逻辑的健壮性。
💡 架构核心决策

将 proxy.ts 的重命名视为一次代码审查的契机:任何触及数据库或作为唯一鉴权点的逻辑,都必须移入 server-only 的数据访问层。剩下的 Proxy 代码应简短且专注。

原文出处与权威溯源声明:
本文核心技术背景源自海外一线技术研究:
Next.js proxy.ts: The Rename Is a Warning Label, Not a New Feature (DEV Community)
CVE-2025-29927 详情参考:NVD

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注