简单来说：这条命令是把nginx_upstream_check_module（主动健康检查模块）的补丁代码，注入到Nginx核心的上游（upstream）调度模块源码中，为Nginx原生的后端调度逻辑添加“健康状态感知”能力。下面拆解具体发生的事：
一、先理解patch命令的基础作用
patch -p1 < ../nginx_upstream_check_module-master/check_1.20.1+.patch
-p1：忽略补丁文件中路径的第一层目录（适配补丁文件的路径结构，确保能找到Nginx源码文件）；- 补丁文件
check_1.20.1+.patch：是模块作者针对Nginx 1.20.1及以上版本编写的代码差异文件（记录了“需要给Nginx源码改哪些地方、加哪些代码”）； - 执行后：patch工具会自动对比Nginx源码文件和补丁文件的差异，把补丁中的代码修改“合并”到Nginx对应的源码文件中。
二、被修改的5个文件，各自发生了什么？
这些文件都是Nginx上游（upstream）调度模块的核心源码，补丁的修改围绕“让调度算法能识别后端节点的健康状态，跳过故障节点”展开：
| 被修改的文件 | 对应Nginx功能 | 补丁做了什么修改 | 最终效果 |
|---|---|---|---|
src/http/modules/ngx_http_upstream_hash_module.c |
哈希（hash）调度模块（按自定义key分发请求） | 1. 添加“节点健康状态”变量； 2. 修改哈希映射逻辑：计算哈希值时，自动排除标记为“故障”的节点； 3. 避免将请求分发到故障节点后，哈希结果偏移导致的请求分发混乱 |
哈希调度模式下，只向健康节点分发请求，故障节点被排除在哈希计算之外 |
src/http/modules/ngx_http_upstream_ip_hash_module.c |
IP哈希（ip_hash）调度模块（按客户端IP固定分发到后端） | 1. 新增“故障节点跳过逻辑”； 2. 当某节点故障时，同一IP的请求会自动跳转到下一个健康节点； 3. 节点恢复后，重新纳入IP哈希调度（保证IP哈希的一致性） |
IP哈希模式下，避免把同一客户端的请求分发到故障节点，同时尽量保留IP哈希的核心特性 |
src/http/modules/ngx_http_upstream_least_conn_module.c |
最少连接数（least_conn）调度模块（向连接数最少的后端分发请求） | 1. 修改“连接数统计逻辑”：只统计健康节点的连接数； 2. 筛选候选节点时，直接过滤故障节点 |
最少连接数调度时，只在健康节点中选择“连接数最少”的，不会选故障节点 |
src/http/ngx_http_upstream_round_robin.c |
轮询（round_robin）调度模块（Nginx默认调度方式，按顺序分发） | 1. 给轮询算法添加“节点健康状态标记位”（up/down）； 2. 修改轮询选节点的核心逻辑：遍历节点列表时，跳过标记为down的故障节点； 3. 新增“故障节点恢复检测”逻辑 |
轮询调度时，自动跳过故障节点，只在健康节点中按顺序分发请求 |
src/http/ngx_http_upstream_round_robin.h |
轮询调度模块的头文件（定义数据结构、函数声明） | 1. 添加“健康状态”相关的结构体字段（如ngx_http_upstream_rr_peer_t中新增health字段）；2. 声明健康检查相关的函数（如节点状态更新、筛选函数） |
为轮询模块的健康状态管理提供数据结构和函数支撑 |
三、执行patch后，Nginx源码的整体变化总结
- 新增核心能力：给Nginx原生的4种核心上游调度算法（哈希、IP哈希、最少连接、轮询）都加上了“健康状态感知”，从“无脑按算法分发”变成“先筛选健康节点，再按算法分发”；
- 无破坏性修改：补丁是“增量修改”，不会删除Nginx原有逻辑，只是在原有调度逻辑上叠加“故障节点过滤”；
- 需编译生效：patch只是修改了源码文件，此时Nginx还不能用主动健康检查——必须执行
./configure && make && make install重新编译Nginx，这些修改才会被编译进Nginx可执行文件中。
四、补充：执行patch时的常见情况
- 正常情况：输出你贴的“patching file xxx”，说明每个文件都成功应用了补丁，无冲突；
- 异常情况：如果提示“hunk FAILED”（补丁块失败），大概率是Nginx版本和补丁版本不匹配（比如用1.18版本打1.20.1+的补丁），需要找对应版本的补丁；
- 验证修改：打补丁后，可打开被修改的文件（如
ngx_http_upstream_round_robin.c），能看到新增的健康状态相关代码（比如peer->health、ngx_http_upstream_check_peer等）。
总结
- 执行这条patch命令的核心是修改Nginx上游调度模块的源码，为原生调度算法添加“识别故障节点、跳过故障节点”的逻辑；
- 被修改的5个文件覆盖了Nginx所有核心上游调度模式，确保无论用哪种调度方式，都能屏蔽故障后端；
- 补丁仅修改源码，需重新编译Nginx才能让主动健康检查功能生效。