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 失败为例：

1. 重新编译 Nginx：./configure --with-debug && make && sudo make install
2. 设置环境并启动：NGX_DEBUG_POINTS=fork_failed nginx -g "daemon off; worker_processes 4;"
3. 当 fork 失败发生时，Master 进程会暂停并打印类似 debug point: fork_failed 到 stderr
4. 另开终端执行：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，因其信号行为受限