debug_points
当在处理过程中达到特定调试点时,`debug_points` 指令会控制 NGINX 的行为。 — NGINX Core
debug_points
main
语法debug_points stop | abort;
默认值none
上下文main
模块NGINX Core
参数1
说明
`debug_points` 指令面向希望为调试目的操纵 NGINX 服务器执行流程的开发者和高级用户。该指令可以在主上下文中配置,并接受一个指定应触发哪个调试点的单个参数。该指令可用的操作数是 `stop` 和 `abort`,在执行过程中达到时它们会以不同方式影响 NGINX 进程。 当设置为 `stop` 时,NGINX 会在定义的调试点暂停执行,允许用户在需要时附加调试器。这对于对应用在响应特定请求或系统事件时的行为进行逐步分析尤为有用。另一方面,选择 `abort` 会导致进程立即终止,这对于调试致命错误或在特定不良状态下确保系统完整性很有帮助。 `debug_points` 指令的行为可以大大增强在开发或排查 NGINX 模块和配置时的调试体验。它作为一种在不修改实际源代码的情况下在代码中引入有意断点的机制,从而促进更有效的调试工作流。
配置示例
debug_points stop;
⚠
请确保您的 NGINX 构建已启用调试支持,否则该指令可能无法正常工作。
⚠
使用 `debug_points` 会影响 NGINX 的性能;在生产环境中应将其移除或注释掉。