Hyperf是一款基于Swoole/Swow扩展的高性能PHP协程框架，在日常开发过程中，合理的调试技巧和正确的调试模式配置，能帮助我们更快速地定位问题、提升开发效率。很多开发者仅使用基础的日志打印方式调试，其实框架内置了更多实用的调试功能，同时调试模式也支持多种灵活调整。
Hyperf基础调试配置调整
Hyperf的调试模式主要通过环境变量和配置文件共同控制，我们可以根据不同的开发场景调整对应的配置。
环境变量配置
在项目的.env文件中，我们可以通过APP_DEBUG参数控制全局调试开关，设置为true时会开启更多调试信息输出：
APP_DEBUG=true
配置文件调整
调试相关的核心配置位于config/autoload/debug.php，我们可以在这里配置调试模式的启用条件、异常显示方式等内容：
<?php
return [
// 是否启用调试模式，支持闭包自定义判断逻辑
'enable' => (bool) env('APP_DEBUG', false),
// 异常渲染器配置，调试模式下可以显示更详细的异常堆栈
'exception' => [
'renderer' => [
'class' => HyperfExceptionHandlerFormatterDefaultFormatter::class,
],
],
];
Hyperf隐藏调试技巧汇总
1. 协程上下文调试
Hyperf运行在协程环境下，普通全局变量无法在协程间共享，我们可以通过协程上下文存储调试信息：
<?php
use HyperfContextContext;
// 存储调试信息到协程上下文
Context::set('debug_test_key', '当前协程的调试数据');
// 获取上下文中的调试信息
$debugData = Context::get('debug_test_key');
var_dump($debugData);
2. 运行时修改日志级别
不需要频繁修改配置文件，我们可以在代码运行时临时调整日志输出级别，方便针对性调试：
<?php
use HyperfLoggerLoggerFactory;
use PsrLogLogLevel;
// 获取日志实例
$logger = (new LoggerFactory())->get('debug_logger');
// 临时设置日志级别为DEBUG
$logger->setLevel(LogLevel::DEBUG);
// 输出调试日志
$logger->debug('这是运行时调试输出的日志内容', ['request_id' => uniqid()]);
3. 依赖注入容器调试
当需要排查依赖注入相关问题时，可以打印容器内的所有绑定定义：
<?php use HyperfDiContainer; use HyperfDiDefinitionDefinitionSource; // 获取容器实例 $container = HyperfContextApplicationContext::getContainer(); // 获取所有定义 $definitions = $container->getDefinitionSource()->getDefinitions(); // 打印定义的键名，排查注入问题 var_dump(array_keys($definitions));
4. Swow扩展下的调试技巧
如果使用Swow作为运行驱动，可以开启Swow的调试日志，查看协程调度相关的详细信息：
<?php // 在入口文件或启动脚本中开启Swow调试日志 SwowDebug::enableLog(); // 设置日志级别为DEBUG SwowDebug::setLogLevel(SWOW_LOG_DEBUG);
不同场景下的调试模式选择
我们可以根据开发阶段选择合适的调试模式，避免过度输出调试信息影响性能：
| 开发阶段 | APP_DEBUG配置 | 适用场景 |
|---|---|---|
| 本地开发 | true | 需要详细异常堆栈、调试日志输出，快速定位代码问题 |
| 测试环境 | true | 排查测试过程中出现的异常，保留调试信息方便回溯 |
| 预发布环境 | false | 仅保留必要日志，避免调试信息泄露敏感数据 |
| 生产环境 | false | 关闭所有调试功能，保障服务性能和数据安全 |
调试注意事项
- 生产环境务必关闭
APP_DEBUG，避免暴露服务器路径、数据库配置等敏感信息 - 协程场景下的调试不要使用全局静态变量存储临时调试数据，避免协程间数据污染
- 调试完成后及时删除临时的调试代码，避免影响服务正常运行
- 如果使用Docker部署，修改
.env后需要重启容器才能让配置生效
上述技巧覆盖了Hyperf开发过程中大部分常见调试场景，开发者可以根据实际需求灵活组合使用，提升问题排查的效率。