CVE-2026-119790 影响范围与修复:unstable_cache 嵌套 use cach

6
发布时间:2026-11-17 09:02:18

2026 年 11 月 16 日,Next.js 发布 November 2026 Security Release,集中披露了多个安全漏洞,修复版本为 16.4.5 与 15.5.29。其中 CVE-2026-119790 尤为值得关注:它不是传统的注入或 RCE 类漏洞,而是一个由缓存 key 构造不一致引发的跨租户数据泄露,利用条件狭窄但后果直接——一个租户的缓存数据可能被另一个租户读到。

本文围绕 CVE-2026-119790 的影响范围、技术机制、代码特征和修复步骤展开,供仍在使用 Next.js 16 的项目参考排查。


漏洞概述

CVE-2026-119790 的官方描述指出:在 Next.js 16.3.0 至 16.4.4 中,如果同一个 'use cache' 函数既在渲染路径中直接调用,又被 unstable_cache() 包裹后调用,并且该函数内部通过 next/root-params 读取了 root param(例如租户标识或 locale),缓存数据就可能在不同 root param 之间发生泄露。

CVSS 评分 6.3,GitHub Advisory 评级为 Moderate。利用窗口非常具体:仅在服务器进程冷启动后的首次缓存填充期间,并发的 unstable_cache() 请求可能加入直接调用的 in-flight 填充,拿到结果后以不含 root param 的 key 持久化,后续其他 root param 的请求会持续命中这条错误条目,直到它被 revalidate 或 eviction。

在竞争窗口之外,'use cache' 嵌套在 unstable_cache() 内部本身就会抛出错误。问题的核心在于:这道安全检查在冷启动的窄窗口里存在一个漏洞。


影响范围

受影响版本:16.3.0 ≤ next < 16.4.5(即 16.3.0 至 16.4.4)。15.x 线不受 CVE-2026-119790 影响。

暴露前提,三个条件必须同时满足:

  1. 应用启用了 Cache Components(cacheComponents: true);

  2. 存在一个 'use cache' 函数,内部读取了 root param(通过 next/root-params);

  3. 该函数被 unstable_cache() 包裹调用。

如果代码中没有出现 next/root-params,该漏洞的基本前提即不成立。


技术机制:两套缓存 key,两种“身份”认知

'use cache' 和 unstable_cache() 在构造缓存 key 时依赖不同的输入,这是漏洞的结构性根源。

'use cache' 的 key 包含构建 ID、函数 ID、可序列化参数、闭包变量,以及该函数实际读取的 root param。由于 root param 是通过静态可分析的 getter(如从 next/root-params 导入的 locale 或 tenant)读取的,Next.js 能够精确知道某个缓存函数依赖了哪个 root param,并将其纳入 key。

unstable_cache() 的 key 则只由函数参数和可选的 keyParts 数组构成,完全不包含 root param。它早于 root-params API 存在,没有机制发现被包裹函数从环境中读取了什么。

正常情况下,'use cache' 嵌套在 unstable_cache() 内会立即报错,阻止危险组合生效。但在冷启动首次填充的瞬间,unstable_cache() 调用可能“搭上”直接调用的 in-flight 结果,绕过拒绝,然后以自身的 key(不含 root param)持久化该结果。此后,无论请求的是哪个 root param 值,只要参数和函数签名匹配,都会读到同一条条目。

以下代码示意了危险模式:

// 危险:'use cache' 函数读取 root param,却被 unstable_cache() 包裹
import { unstable_cache } from 'next/cache';
import { tenant } from 'next/root-params';

async function getData() {
  'use cache';
  const t = await tenant();        // 读取 root param
  return fetchTenantData(t);
}

// 在路由处理器、后台任务等渲染路径之外的地方:
const cached = unstable_cache(getData, ['tenant-data']);

unstable_cache 的 keyParts 即使手动加入租户标识,也无法从根本上修复该问题,因为嵌套本身是不受支持的组合。


为什么升级之后还必须清理缓存

这是本次处置中最容易被遗漏的一步。

升级到 16.4.5 修复的是竞争窗口本身:新版本不会再允许 unstable_cache() 加入 'use cache' 的 in-flight 填充。但已经被污染并持久化的旧缓存条目不会因为升级而消失。Next.js 的 Data Cache 设计上跨部署持久化,重新部署代码并不会自动清除它。

如果升级后不 purge 旧条目,那些以不含 root param 的 key 写入的错误数据会继续被读取,泄露可能持续存在。官方和多方分析均明确建议:使用 'use cache' 且涉及 root param 的应用,在升级后必须清理缓存。

清理范围包括:

  • 'use cache' 持久化条目;

  • unstable_cache() 持久化条目;

  • 共享 Data Cache 中相关的 fetch 缓存条目。

如果使用 Vercel,可通过项目的 CDN → Caches → Purge cache → All content 执行清除;自托管场景则需要按所用缓存适配器的机制清理持久化存储。


排查与修复清单

第一步:确认版本

npm ls next

16.x < 16.4.5 在受影响范围内。15.x 线不受该 CVE 影响,但仍需评估同批发布的其他漏洞。

第二步:升级

npm install next@16.4.5

或升级到 16.x 线的最新稳定版。修复版本中 unstable_cache() 已无法在冷启动窗口加入 'use cache' 的 in-flight 填充。

第三步:部署后 purge 持久化 Data Cache

升级并重新部署之后,清理共享的持久化缓存条目。仅重新部署而不清理缓存,旧污染条目仍会继续被服务。

第四步:代码侧移除危险嵌套

全库搜索 unstable_cache( 与 'use cache' 的共现,重点检查读取了 next/root-params 的函数:

grep -rn "unstable_cache" src app 
grep -rn "use cache" src app 
grep -rn "next/root-params" src app

一旦确认 unstable_cache() 包裹了 'use cache' 函数,移除嵌套。官方明确指出,避免这种嵌套是完整的 workaround,即使在升级之后,它也不是受支持的组合,不应继续保留。

第五步:长期约束

unstable_cache 在 Next.js 16 中已被标记为旧方案,新代码应优先使用 'use cache' 配合 cacheLife() 和 cacheTag()。如果需要在渲染路径之外使用缓存(webhook、cron、route handler),应直接缓存数据获取函数本身,而不是包裹一个为渲染设计的 'use cache' 函数。


小结

CVE-2026-119790 的本质是两套缓存 key 机制对“缓存身份”的认知不一致:'use cache' 知道 root param 的存在,unstable_cache() 不知道。冷启动竞争窗口把这个不一致从“理论上不该发生”变成了“实际可被利用”。处置的关键不是一行 npm install,而是 升级 + 清缓存 + 移除嵌套三步并行。对于多租户或按 locale 分站的 Next.js 16 应用,建议把这次排查作为一次缓存 key 审计的入口,而不仅是一次性的补丁操作。

有疑问?试试 AI 助手,答案来自站内真实资料