调试swoole需以日志和异常捕获为核心，因var_dump等传统方式无效；首先启用swoole.display_errors=1并配置log_file路径，通过server->set(['log_level'=>0])开启全量日志，开发时保持daemonize=false；在协程中必须使用try-catch捕获异常，因协程异常不会自动冒泡，可注册全局处理器；可结合xdebug在cli模式下断点调试非协程逻辑；推荐使用file_put_contents配合coroutine::getcid()记录带协程id的调试日志，避免热循环频繁输出；最终一切以日志为准，形成系统化调试习惯。
调试 Swoole 代码中的错误，关键在于理解 Swoole 的异步、协程和常驻内存特性。传统的 PHP 调试方式（比如 var_dump 或 echo）在 Swoole 中可能不起作用或输出不完整，因此需要更系统的方法来定位问题。
启用 Swoole 错误报告和日志
Swoole 提供了详细的日志功能，能帮助你捕获运行时错误和警告：
- 设置 swoole.display_errors = 1 确保错误信息输出到控制台（开发环境）
- 使用 swoole.log_file 配置日志文件路径，记录所有 Swoole 内部错误
- 在代码中调用 Swoole\Runtime::enableCoroutine() 前设置错误处理
- 通过 server->set(['log_level' => 0]) 开启最详细日志级别（0 表示全部日志）
例如：
$server->set([ 'log_level' => 0, 'daemonize' => false, // 开发时不要后台运行 ]);使用 try-catch 捕获协程异常
Swoole 大量使用协程，未捕获的异常会导致协程退出但主进程继续运行，容易被忽略：
- 在 go() 启动的协程中必须使用 try-catch 包裹业务逻辑
- 注意：协程内的异常不会自动冒泡到主线程，需手动处理
- 可以注册全局异常处理器：Swoole\Coroutine::set(['hook_flags' => ...])
示例：
go(function () { try { // 可能出错的协程代码 $client = new Swoole\Coroutine\Http\Client('http://example.com', 80); $client->get('/'); } catch (Throwable $e) { echo "协程异常: {$e->getMessage()}\n"; } });结合 Xdebug 进行断点调试
虽然 Swoole 和 Xdebug 存在兼容性问题（尤其高版本），但在某些模式下仍可使用：
- 关闭 daemonize，让服务前台运行
- 使用 CLI 模式启动服务，配合 PHPStorm + Xdebug 设置断点
- 注意：协程切换可能导致堆栈混乱，建议只调试非协程部分或简单逻辑
- 可临时将逻辑抽离成普通函数，在传统 PHP 环境中单独测试
打印调试与自定义日志
最直接有效的方式是写日志：
- 使用 file_put_contents('debug.log', print_r($data, true), FILE_APPEND)
- 封装一个简单的 debug 函数，输出时间、协程 ID、变量内容
- 利用 Swoole\Coroutine::getCid() 查看当前协程 ID，追踪执行流
- 注意：不要在热循环中频繁打印，影响性能
基本上就这些。Swoole 调试重在日志和异常捕获，配合合理的开发习惯，多数问题都能快速定位。关键是别依赖浏览器输出，一切以日志为准。
