在 linux 中给 nginx 源码打第三方补丁，核心做法是进入解压后的源码根目录，使用 patch 命令应用 .patch 或 .diff 文件，确认无冲突后重新执行 ./configure 和 make。具体操作时，需确保补丁文件的上下文与当前源码版本严格匹配，若遇到 hunk #1 failed 错误，说明代码结构不一致，此时应检查版本兼容性或手动修复冲突。

patch 命令如何验证补丁是否成功应用

使用 patch -p1 命令后，终端会输出每个 Hunk（块）的处理结果。如果显示 Hunk #1 succeeded，表示该部分代码已成功修改；若出现 Fuzz 提示，表示行号有微小偏差但内容匹配，通常可接受；若出现 FAILED，则必须处理。验证成功的最佳方式是查看关键被修改文件的头部注释或特定逻辑分支，例如检查 src/http/ngx_http_core_module.c 中是否包含了补丁新增的指令定义。

# 假设已下载 nginx-1.24.0 源码并解压到 ~/nginx-1.24.0
# 进入源码目录
cd ~/nginx-1.24.0

# 应用补丁，-p1 忽略第一层路径前缀
patch -p1 <p>预期结果：终端输出包含多行 <code>Hunk #N succeeded</code>，且最终 <code>make</code> 编译通过，生成新的 <code>nginx</code> 二进制文件。可通过 <code>nginx -V</code> 查看编译参数，或通过测试新添加的功能来确认补丁生效。</p><h2>遇到 <code>Hunk FAILED</code> 时如何处理冲突</h2><p>当补丁因源码版本差异导致行号不匹配而失败时，可以使用 <code>patch --reject</code> 生成 <code>.rej</code> 文件，或者使用 <code>-R</code> 参数回滚后尝试其他方法。最直接的做法是打开 <code>.rej</code> 文件，对比原始代码和补丁意图，手动在源码中使用编辑器（如 <code>vim</code> 或 <code>sed</code>）进行修正。修正完成后，再次运行 <code>patch</code> 或直接编译，因为手动修改的部分已经符合预期。</p><div class="aritcle_card flexRow artxards">
											<div class="artcardd flexRow">
												<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill12698" title="Linux DO"><img
														src="https://img.php.cn/upload/skill/001/246/273/6adaf20d79f23518.jpg" alt="Linux DO" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
												<div class="aritcle_card_info flexColumn">
													<a rel="nofollow" href="/xiazai/skill12698" title="Linux DO" class="overflowclass">Linux DO</a>
													<p class="overflowclass">Linux DO (linux.do)。任何 Linux DO 请求（搜索、读取数据）均使用此技能。若任务涉及 Linux DO，应使用本技能而非调用其他。</p>
												</div>
												<a rel="nofollow" href="/xiazai/skill12698" title="Linux DO" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
												</a>
											</div>
										</div><p><img src="https://img.php.cn/upload/article/001/242/473/179462151531249.png?x-oss-process=image/resize,p_40" alt="Linux 中 Nginx 源码编译怎么打第三方补丁"></p><pre class="brush:php;toolbar:false;"># 查看失败的 Hunk 详情
patch -p1 --dry-run <p>预期结果：<code>--dry-run</code> 模式显示具体的冲突行号和原因；<code>.rej</code> 文件中包含未应用的代码片段；手动编辑后，<code>make</code> 能够顺利链接并生成二进制文件，无编译错误。</p><h2>如何确认补丁中的新模块已正确加载到 Nginx</h2><p>补丁通常用于添加新模块或修改核心行为。确认加载成功的方法是启动 Nginx 后，使用 <code>nginx -V</code> 查看编译时包含的模块列表，或者使用 <code>nginx -T</code> 查看完整配置及解析情况。如果补丁添加了新的指令（如 <code>my_directive</code>），可以在配置文件中使用该指令并重启 Nginx，观察是否报错。若无报错且功能正常，即表示补丁中的模块已正确集成。</p><pre class="brush:php;toolbar:false;"># 查看编译参数，确认新模块名是否在列表中
nginx -V 2>&1 | grep -o 'with-.*module'

# 在 nginx.conf 中添加补丁引入的新指令
# my_directive on;

# 测试配置语法
nginx -t

# 如果语法正确，重载配置
nginx -s reload

# 检查错误日志确认无异常
sudo tail -f /var/log/nginx/error.log

预期结果：nginx -V 输出中包含补丁引入的模块名称（如 --with-http_my_module）；nginx -t 返回 syntax is ok 和 test is successful；error.log 中无关于未知指令或模块加载失败的错误记录。