# 调试模式

在开发期间启用调试模式，以输出详细的工作进程日志。启用后，工作进程会记录每项任务的领取、执行和状态转换的额外信息。

## 启用调试模式

在 `wp-config.php` 中定义常量：

```php
define( 'QUEUETY_DEBUG', true );
```

## 功能说明

启用调试模式后：

- 工作进程会将 `LogEvent::Debug` 条目写入日志表，记录领取尝试、空队列、资源准入延迟、调度器节拍、速率限制检查和取消领取、任务类反序列化以及处理程序解析
- 每条调试记录的上下文中都包含处理程序 `_worker`、队列和 `message`；任务开始、完成和失败本来就会作为常规事件记录

## 检查调试状态

```php
use Queuety\Config;

if ( Config::debug() ) {
    // Debug mode is active
}
```

## 适用场景

- **开发期间。** 跟踪任务和工作流的完整生命周期，以验证行为。
- **故障排查。** 获取任务失败或工作流停滞原因的详细上下文。
- **性能调查。** 将调试记录与常规 `completed` 事件的 `duration_ms` 和 [指标](https://queuety.inline0.dev/zh/docs/features/metrics) API结合分析。

在生产环境中禁用调试模式，以免大量调试条目填满日志表。调试条目会一直保留，直到你通过 `Queuety::purge_logs()` 清除日志；系统不会自动清除它们。