PHP版本与Swoole扩展ABI不匹配是新手常见问题，需确保php、phpize、php-config三者版本一致；task进程卡住因finish()未在onTask协程上下文中调用；HTTPS请求崩溃多因OpenSSL版本不兼容；内存缓慢上涨需关注Swoole底层内存而非PHP内存统计。
PHP版本和Swoole扩展不匹配导致extension=swoole.so加载失败
这是最常卡住新手的第一步：编译成功了，php.ini也加了配置，但php -m | grep swoole就是没输出，或者启动时报undefined symbol。根本原因不是配置写错了，而是PHP ABI（应用二进制接口）不一致——比如你用PHP 8.2编译的Swoole，却在PHP 8.1的CLI环境下运行。
- 先确认当前CLI用的是哪个PHP：
which php和php -v - 再检查
phpize是不是对应版本：phpize -v；如果不对，得用/path/to/php8.2/bin/phpize重新生成 - 编译时显式指定PHP配置路径：
./configure --with-php-config=/path/to/php8.2/bin/php-config - Docker里尤其容易踩坑：基础镜像PHP版本、
docker build时用的phpize、容器内运行时的php三者必须一致
task进程卡住不finish()，任务队列持续堆积
现象很典型：服务跑着跑着变慢，swoole_server->stats()显示tasking_num一直涨，日志里看不到onFinish回调被触发。这不是代码漏写$server->finish()，而是调用时机或上下文出了问题。
-
finish()必须在onTask回调的协程上下文中调用，不能丢进go()里异步执行（否则$server句柄可能已失效） - 检查
max_task_execution_time是否设得太小，任务超时被强制kill，finish()根本没机会执行 - 用
strace -p $(pgrep -f 'php your_server.php') -e trace=sendto,recvfrom看task进程是否真的发出了完成信号 - 别在
onTask里直接co::sleep(0)或做任何非协程安全的阻塞操作，这会破坏调度器对finish()调用的感知
协程中发起HTTPS请求崩溃或返回空响应
用Co\Http\Client访问https://地址时直接段错误，或者file_get_contents('https://...')报错，但HTTP地址完全正常——这几乎一定是OpenSSL兼容性断裂。Swoole协程HTTP客户端深度依赖PHP的openssl扩展，两者版本/编译参数不一致就会出事。
- 运行
php --ri openssl和php --ri swoole，对比两者的OpenSSL Library Version是否一致 - 常见情况：系统装了OpenSSL 3.x，但PHP是用OpenSSL 1.1编译的，而Swoole又用了系统默认的3.x头文件
- 重编译Swoole时加参数：
./configure --with-openssl-dir=/usr/lib/ssl（路径按你的OpenSSL实际位置调整） - 临时验证可禁用SSL验证（仅测试）：
$client->set(['ssl_verify_peer' => false])，如果这时不崩了，基本锁定是证书链或TLS协议协商问题
内存缓慢上涨，memory_get_usage()监控失灵
长周期运行后内存持续增长，但你在关键协程里加了$before = memory_get_usage(); ...; echo memory_get_usage() - $before却看不出明显泄漏——因为PHP内存统计不包含Swoole底层分配的共享内存、缓存池、连接池对象等。
- 优先看
swoole_server->stats()里的worker_request_count和worker_request_time是否异常高，可能是协程没正确退出导致资源滞留 - 用
valgrind --tool=memcheck --leak-check=full php your_server.php（需带--enable-debug编译Swoole）抓底层C级泄漏 - 检查是否误把PDO/Redis连接赋值给了
static变量或全局数组，协程复用下这些连接会被反复叠加 - 数据库类务必用连接池，别在每个协程里
new PDO()——Swoole不会帮你回收这些原生资源
真正难排查的从来不是报错，而是那些不报错却悄悄变慢、变卡、变胖的服务。协程的“自动调度”背后全是隐式契约，一旦打破，它不会骂你，只会静默地吃掉内存、延迟和稳定性。
