debug_points 是 Nginx 专为开发者设计的底层调试机制，仅在编译启用 --with-debug、运行时设置 NGX_DEBUG_POINTS 环境变量且以非守护模式启动时生效，用于在 fork_failed 等关键错误点主动暂停（SIGSTOP）或触发 core dump，辅助 gdb 分析 Master 进程异常。
debug_points 是 Nginx 中用于调试 Master 进程异常行为的内部机制，**仅在编译时启用了 --with-debug 且运行于调试模式下才有效**。它不适用于常规生产环境，也不能通过 nginx.conf 动态配置，而是依赖源码级编译选项和环境变量控制。
理解 debug_points 的作用范围
该机制专为开发者排查 Master 进程崩溃、信号处理异常、fork 失败、共享内存初始化错误等底层问题设计。它不是用户级断点调试工具（如 GDB），而是让 Nginx 在预设的代码位置主动中止（raise SIGSTOP）或记录日志，便于 attach 调试器分析现场。
常见可触发的 debug_point 包括：
- worker_process_failed：子进程意外退出时
- fork_failed：fork() 系统调用失败
- reconfigure_signal：收到 SIGHUP 但重载失败
- shutdown_signal：收到 SIGTERM/SIGQUIT 但清理卡住
启用 debug_points 的必要条件
必须满足以下全部条件，debug_points 才会生效：
- 源码编译 Nginx 时指定
--with-debug - 启动前设置环境变量
NGX_DEBUG_POINTS=1（或具体点名，如NGX_DEBUG_POINTS=fork_failed） - 以非守护模式运行：
nginx -g "daemon off;"（否则 Master 会 double-fork，SIGSTOP 无法被捕获） - 确保未被 systemd 或容器 init 进程接管——否则 SIGSTOP 会被拦截或忽略
实际调试操作步骤
以定位 fork 失败为例：
- 重新编译 Nginx：
./configure --with-debug && make && sudo make install - 设置环境并启动：
NGX_DEBUG_POINTS=fork_failed nginx -g "daemon off; worker_processes 4;" - 当 fork 失败发生时，Master 进程会暂停并打印类似
debug point: fork_failed到 stderr - 另开终端执行：
gdb -p $(pgrep nginx | head -1)，然后使用info registers、bt、print errno分析上下文
注意事项与替代方案
debug_points 是低层调试辅助，不具备交互式断点能力。若需更灵活调试：
- 优先使用
gdb --args nginx -g "daemon off;"直接对 Master 下断点（如b ngx_master_process_cycle） - 配合
strace -f -p $(pgrep nginx)观察系统调用失败细节 - 检查
error_log /path/to/error.log debug;获取详细日志（需 --with-debug 编译） - 避免在容器或 systemd 服务中直接依赖 debug_points，因其信号行为受限
