最常被误认为Swoole问题的内存耗尽错误实为PHP代码内存泄漏，因Swoole常驻进程放大问题；段错误多因Swoole扩展ABI不匹配；协程异常未捕获会导致Worker静默退出；swoole_loader缺失引发隐性内存故障。
内存耗尽报错 Allowed memory size of 536870912 bytes exhausted
这是最常被误认为“Swoole问题”的PHP内存限制错误，实际和Swoole关系不大——它只是暴露了你代码里长期存在的内存使用失控。PHP默认memory_limit = 512M，而Swoole Worker进程是常驻的，如果每次请求都累积未释放的对象（比如全局缓存、闭包引用、PDO连接未close、协程内变量未unset()），几万次请求后就稳稳触发这个错误。
实操建议：
- 先别急着调高
memory_limit，临时设为1024M只是掩耳盗铃；真正要查的是单次请求的内存增长：在onRequest开头加echo memory_get_usage() . "\n";，结尾再打一次，看差值是否稳定 - 禁用所有第三方SDK或ORM的自动缓存（如Laravel的
Cache::remember在协程里可能跨请求复用） - 检查是否在协程里用了
static变量或全局数组不断[]=追加，这类写法在常驻进程中等于内存泄漏 - 用
php --ri swoole确认Swoole版本，v5.0+开始对协程变量生命周期做了更严格管理，老项目升级后反而暴露旧bug
Worker进程因信号11崩溃，日志只显示Segmentation fault (core dumped)
这不是PHP层能catch住的错误，是C层段错误，常见于扩展不兼容或Swoole内部资源误用。尤其当你没用项目自带的swoole-loader文件时，PHP加载的Swoole.so可能和当前PHP ABI不匹配，运行一阵后随机崩在swString_append或coroutine::get_context这类底层函数里。
实操建议：
- 立刻执行
php --ri swoole | grep "Version\|compiled"，比对PHP版本与Swoole编译时的PHP版本是否一致；不一致必须重编译，不能靠pecl install偷懒 - 检查是否手动调用了
swTimer_add等C API（极少见但存在），这些函数在新版Swoole中已被废弃，调用即崩溃 - 启用core dump：
ulimit -c unlimited+ 在swoole_server配置里加上'core_dump' => true，用gdb php core定位具体崩溃点 - 如果你用的是Docker，确认基础镜像里的
php-dev和运行时php版本完全一致——Alpine和Debian混用是高频翻车点
协程内异常未捕获导致Worker静默退出
Swoole协程里抛出未捕获异常，不会像FPM那样返回500，而是直接终止该协程，若恰巧这是最后一个活跃协程，Worker进程就会退出并被Master拉起——你看到的现象是“服务偶尔卡顿1秒”，日志里只有WORKER EXIT，毫无异常痕迹。
实操建议：
- 每个
go(function () { ... })入口必须套try-catch (\Throwable $e)，且至少记录$e->getTraceAsString()，不要只打$e->getMessage() - 设置
swoole_set_process_name("php-worker-{$pid}")，配合ps aux | grep php-worker快速定位哪个Worker反复重启 - 在
onWorkerStart里注册set_exception_handler，捕获所有漏网异常；但注意：它无法捕获致命错误（如Fatal error: Allowed memory size exhausted） - 避免在协程里
include或require动态文件——文件路径错误会触发Warning而非Exception，set_exception_handler收不到
swoole_loader缺失引发的隐性内存故障
项目自带的swoole-loader不是可选组件，它是针对当前Swoole版本和PHP环境预编译的轻量级加载器，绕过PHP原生扩展加载机制。一旦跳过它，改用系统级extension=swoole.so，就可能触发ABI不兼容——表现为内存占用缓慢爬升（每小时+2MB）、strace看到大量mmap失败、valgrind报告无效读写。
实操建议：
- 确认
php.ini里没有extension=swoole.so这一行；正确做法是删掉它，改用require_once __DIR__ . '/vendor/swoole/ext/swoole_loader.php'; - 检查
swoole_loader.php文件头是否含if (!extension_loaded('swoole')) { ... }逻辑，有些旧版loader会静默跳过加载，需手动触发Swoole\Loader::load() - 在
onWorkerStart里加断言：assert(extension_loaded('swoole'), 'swoole extension not loaded via loader');，避免部署时漏掉关键步骤
真正难排查的从来不是报错本身，而是那些不报错却让内存每天多占1MB的服务——它们往往藏在loader没加载、异常没兜底、缓存没清理这三个地方，而且越稳定的线上环境越容易忽略。
