返回博客
2026年11月17日Sergei Solod13 分钟阅读

静态 Next.js 网站的 nginx CPU 占用过高:优化正则重定向规则

一个静态 Next.js 网站因 nginx 的正则重定向映射而消耗大量 CPU。通过精确键查找、真实 HTTP 行为一致性测试和受控基准测试,在保留旧页面及媒体 URL 可用性的同时,大幅降低了 CPU 开销。

Nginx性能PCRE重定向Next.js

前端早已编译成静态 HTML,由 nginx 直接提供生成的页面和媒体文件,但 nginx 工作进程处理普通请求时,CPU 占用却高得出乎意料。这里没有需要逐请求优化的 Next.js 渲染。真正耗费资源的操作发生得更早:nginx 必须判断每个 URL 是否属于一组不断增长的历史重定向规则。

最终的修复方案保留了所有旧链接的可用性。页面重定向、带序号的图片别名和视频别名都没有删除,只是将数千次正则表达式匹配替换为少量路径结构匹配和哈希表查找。改动部署后,按照原有路由行为进行了测试。在针对特定混合请求、可重复的受控基准测试中,nginx 工作进程消耗的 CPU 时间降低了 100 多倍,而 HTTP 响应保持不变。

为什么静态导出的 Next.js 网站仍会受 CPU 性能限制

静态导出将页面渲染移出了请求处理流程,却不会消除 nginx 的路由逻辑。在提供 HTML 页面或图片之前,nginx 可能需要规范化路径、求值重定向映射、选择 location、检查文件是否存在,并生成响应。即使文件系统再快,也无法抵消每次请求都要重复执行的昂贵 URL 匹配。

配置中逐渐积累了两类历史规则。旧页面的精确别名指向新的规范路径;分页别名同样将停用路径重定向到新地址,但它们遵循共同的结构模式。此外,重命名后的媒体路径通过表达式捕获可选的图片序号,视频文件名也有自己的别名规则。问题不在于存在重定向,而在于大量结构相似的重定向被写成了一条条独立的正则表达式。

先排除表现相似的 CPU 问题

网站运行在虚拟化 Linux 环境中,因此一开始也考虑过虚拟机监控程序造成的 CPU steal 时间。我比较了 CPU 使用率、steal 时间、进程级 CPU 消耗、内存压力和磁盘等待情况,而不是直接把较高的系统平均负载当成诊断结论。使用的基础工具如下:

mpstat -P ALL 1 5
pidstat -u -C nginx 1 5
vmstat -w 1 6

MASTER=$(systemctl show nginx -p MainPID --value)
WORKERS=$(pgrep -P "$MASTER" -d,)
perf record -F 49 -g -p "$WORKERS" -- sleep 10
perf report --stdio --no-children -g none

关键观察结果是:nginx 工作进程消耗了大量用户态 CPU 时间,而 CPU steal 时间相对较少。测量结果并不支持持续的磁盘等待或活跃的内存交换是主要原因这一判断。进程级数据告诉我哪个程序在忙;perf 则帮助我确定它在做什么。

在一次采样中,约三分之一的 CPU 采样活动归因于 pcre_exec,此外还有一部分时间花在 ngx_http_regex_exec 和 ngx_regex_exec 上。这些正是 nginx 通过 PCRE 执行正则表达式时预期会调用的函数。性能剖析并未证明究竟是哪一张重定向映射导致了问题,但与静态 HTML 渲染有问题相比,反复执行正则匹配显然成为了更有力的解释。

nginx map 中顺序匹配正则规则的隐性开销

nginx 的 map 本身并不慢。字面字符串键可以高效查找;正则表达式条目则是在优先级更高的匹配类别之后,按照配置顺序依次尝试。映射变量只有在被引用时才会求值,因此,如果某张大型正则映射的结果被频繁请求所使用,代价就会显现出来。即使是一张已经存在、完全不匹配任何历史别名的规范图片,nginx 在返回图片字节前也可能先经历大量失败的匹配。

这也解释了为什么简单统计所有 location ~ 块会误导判断。正则 location 的选择与 map 内部执行正则匹配是两种不同的机制。性能剖析能找出耗时的操作类别;进一步检查请求处理路径以及哪些地方使用了映射变量,才能确定这些操作在哪里被触发。

继续隔离问题后发现,媒体规则列表并不是唯一来源。另一组用于页面分页重定向的规则,在对应映射求值时也产生了大量正则匹配开销。只优化图片规则,仍会留下这部分独立成本。

页面重定向:一种分页模式,却有数千个精确目标地址

页面规则具有重复性:路径中的旧标识符不同,而路径末尾都符合类似 /topics/old-a/page/99 的分页模式。一种看似方便的改写方式,是提取 99 并将其附加到新 slug 后面。但这会造成错误。有些历史分页规则有意将任何请求页码都映射到固定的最终页面,例如 /topics/current-a/page/7,无论原请求的是第 3 页还是第 99 页。

还有一个重要约束:nginx 会优先匹配 map 中的精确键,而不是正则表达式。有些精确条目会覆盖通用分页规则的结果;另一些则明确映射为空字符串,以阻止已采用规范路径的 URL 再次重定向。如果只检查返回的目标地址是否非空,就无法区分不存在精确匹配与精确匹配存在,但其值为空这两种情况。

替代方案将路径识别与目标地址选择分开。下面是一个经过简化、使用虚构路径的 nginx http 级映射示例:

# http context: synthetic page aliases
map $uri $normalized_path {
    default $uri;
    ~^(.+)/$ $1;
}

map $normalized_path $exact_target {
    default "__NO_EXACT__";
    /topics/old-a        /topics/current-a;
    /topics/old-a/page/2 /topics/current-a/page/2;
    /topics/old-b/page/2 "";
}

map $normalized_path $pagination_key {
    default "";
    ~^/(?<old_root>topics/[a-z0-9-]+)/page/[1-9][0-9]*$ /$old_root;
}

map $pagination_key $pagination_target {
    default "";
    /topics/old-a /topics/current-a/page/7;
    /topics/old-b /topics/current-b/page/6;
}

map $exact_target $redirect_target {
    default $exact_target;
    __NO_EXACT__ $pagination_target;
}

第一张映射保留了对末尾斜杠的规范化处理。第二张存储精确重定向及显式的空值覆盖规则,并用一个哨兵值表示不存在精确条目。第三张通过单条正则表达式提取分页根路径。第四张对该根路径进行精确键查找,得到原来规定的固定目标地址。最后,选择器先采用所有精确匹配结果(包括空值覆盖规则),只有不存在精确匹配时才考虑分页规则的结果。

随后,执行重定向的服务器仅在 $redirect_target 非空时使用它,并保留原有 HTTP 状态码;如果现行策略要求保留查询字符串,还会附加 $is_args$args。哨兵值必须预留并经过验证,确保它不会与真实目标地址冲突。示例使用的是中性路径;生产环境中的生成器仍须完整保留自身的映射规则清单和既有优先级。

这种设计很容易忽略大小写行为。nginx 比较 map 的字面字符串键时不区分大小写,但使用 ~ 编写的正则表达式区分大小写。因此,不能随意将所有 URL 转为小写,也不能直接把 ~ 规则改成 ~*,然后声称结果等价。替代实现必须复现原有的匹配语义。

图片与视频重定向:只解析一次,再查找旧标识符

媒体规则也具有可以利用的共同结构。旧图片路径的目录名和文件名中都会出现图库标识符,后面还可能带有数字后缀,例如 /old-gallery/old-gallery-17.avif。目标路径沿用这个后缀,但替换目录和文件名前缀。为每个旧图库和每种后缀形式分别生成正则表达式,只会在遵循相同语法的比较上白白消耗 CPU。

更高效的做法是:先用一条正则表达式提取标识符和可选后缀,再通过字面键查找新的路径前缀:

# http context: synthetic AVIF rename inventory
map $uri $legacy_image_key {
    default "";
    ~^/(?<old_id>[a-z0-9-]+)/\k<old_id>(?<image_number>-[0-9]+)?\.avif$ $old_id;
}

map $legacy_image_key $new_image_prefix {
    default "";
    old-gallery /new-gallery/new-gallery;
    old-set     /new-set/new-set;
}

# A recognized alias now has a target candidate:
# $new_image_prefix$image_number.avif
# Existing-file checks and the actual 301 remain
# in the site's media-serving configuration.

对于识别出的别名,/old-gallery/old-gallery-17.avif 会生成候选目标 /new-gallery/new-gallery-17.avif。这只是查找机制,并非完整的文件服务策略。实际部署时,优先提供现有文件、检查目标文件是否存在以及是否返回 301,仍由媒体服务配置负责。如果目标文件不存在,简化示例中无条件返回 301 就是错误的替代做法。

视频重定向采用了类似的方式:用一条匹配文件名结构的正则表达式配合精确键表。既有的 WebP 兼容路径也必须保留,它会将历史别名查找规范化后交给图片映射处理。只有当前文件仍能返回正确的字节内容和响应头,而且访问旧视频别名时仍能针对范围请求返回 206 Partial Content,媒体优化才算成功。

这些示例之所以成立,只是因为历史规则清单中的文件名遵循可预测的语法。如果任意单个文件曾被各自独立地重命名,安全方案就应采用逐文件精确键、生成的索引或其他有界查找方式,而不是假装一条正则表达式能还原毫无共同模式的目标地址。

独立的 410 映射后来如何处理

配置中的另一部分曾明确列出已停用页面的模式,唯一目的就是返回 410 Gone。在验证现有静态文件路由策略已经会对确实不存在的页面返回 410 后,这张专用映射被移除了。历史停用记录仍保留供验证使用;删掉的只是请求处理期间多余的匹配步骤。

这是针对特定配置作出的决定,并非 nginx 的默认行为。除非另有配置,单独使用 try_files 往往最终会返回 404。只有当实际服务器对缺失资源的处理路径仍会返回要求的 410——包括已停用的分页 URL 以及任何内部错误页处理——移除显式的 410 规则才是安全的。在接受这项改动之前,已经通过真实 HTTP 请求验证了这一条件。

如何证明更快的重定向映射仍保持原有行为

即使 nginx 配置在语法上完全有效,也可能悄无声息地破坏数千条历史链接。因此,替代方案将原始规则清单作为独立的正确性依据,而不是从优化后的输出反推一组目标地址。生成的查找表会检查重复键、不支持的表达式、不一致的图片前缀和过期的生成文件。任何无法安全表达的规则都必须使生成过程失败,而不能被悄悄丢弃。

测试矩阵覆盖了精确页面别名、规范路径的空值覆盖规则、相互重叠的分页规则、固定的分页上限、有效与无效页码、末尾斜杠、大小写变体和查询字符串。媒体测试覆盖了基础图片和带序号图片、含前导零的后缀、以数字结尾的标识符、嵌套目标路径、WebP 兼容性以及原有视频别名。在涉及文件服务的场景中,测试使用真实可读取的测试文件,并比较了响应体、重定向、缓存相关响应头以及视频字节范围。

最重要的是,这些测试是通过真实 nginx 发起的 HTTP 检查,而不只是 JavaScript 中的字符串比较。生成的请求矩阵被用于测试新配置;另外一组请求则用于测试原来基于 PCRE 的配置。报告的结果是:未发现任何非预期的响应差异。随后在生产环境进行的冒烟测试也确认,优化后的 include 配置已生效,之前冗长的正则规则表则不再启用。

通过受控基准测试,将优化效果与流量变化区分开

部署后,生产环境的 CPU 监控曲线明显改善,但请求数量和请求类型的构成也发生了变化。如果把一个高负载时段的样本与之后的低负载样本直接比较,就会夸大能够归因于配置改动的收益。

为了单独衡量查找开销,一项独立的基准测试使用相同的 nginx 二进制程序,让原始配置和优化配置重复处理同一组混合请求序列。序列包括规范页面、历史页面别名、分页别名、不存在的页面、规范图片、历史图片与视频别名,以及不存在的媒体文件。测试轮次交错安排为“旧、新、新、旧”;响应状态码和 Location 值一致。

对于这组受控工作负载,优化后的映射所消耗的 nginx 工作进程 CPU 时间不到原先大量使用正则表达式的映射的百分之一,而且重复测试也得到了相同结论。这有力地衡量了在该请求组合下,重定向处理方式改动带来的效果。但这并不意味着生产环境中的每个请求都快了 100 倍,也不意味着任意流量情况下服务器整体 CPU 消耗都会按相同比例下降。

后续系统检查发现,nginx 的 CPU 消耗很低,磁盘压力较小,处理器也有充足的空闲时间。先前的 PCRE 热点不再主导改动后取得的采样结果;不过,由于此时 CPU 占用很低,采样数据十分稀疏,不应过度解读各函数所占的百分比。受控对比、行为一致性测试和成功部署,才是证明修复有效的更强证据。

大规模 nginx 重定向迁移的更安全流程

如果要为另一个拥有大量旧 URL 的网站执行同类迁移,我会尽量采用机械化的流程:保留原始规则清单,识别少数几种共用的路径语法,将每种语法编译为匹配范围受限的正则表达式,并通过字面键映射保存目标地址。精确的规范路径覆盖规则、HTTP 状态码、现有文件检查、查询字符串、主机名规范化和大小写敏感性,都应视为对外可见的行为,而不是可以随意改变的实现细节。

接下来,用 nginx -t 验证完整的生成配置,通过真实 nginx 对比新旧行为,对相同请求进行基准测试,并在部署时准备可恢复的备份和重载后的检查。如果某条重定向无法用结构化方案安全表示,就保留范围明确的例外规则,或者使用逐 URL 精确条目,而不是悄悄将它删除。

这次诊断中真正有价值的思路转变,是认识到静态文件交付高效与路由查找开销低,是两回事。Next.js 早已完成渲染,nginx 也能高效地提供文件;尚未优化的是提供文件之前执行的查找过程。保留旧链接与提高查找效率并不矛盾。

有关精确的优先级和求值规则,请参阅 nginx 官方文档中的 map 模块和HTTP 核心模块的 location 选择机制。