Swoole 无内置版本回滚机制，需手动卸载新扩展并编译安装指定旧版本源码，确保与当前 PHP 版本及编译参数完全兼容，并验证协程、HTTP 服务等核心功能正常。
Swoole 本身不提供“版本回滚”机制——它不是服务端运行时自带版本管理的数据库或包管理器，而是一个 PHP 扩展。所谓“回滚”，本质是卸载新扩展、重装旧扩展，并确保 PHP 运行环境与之兼容。
如何安全卸载当前 Swoole 扩展
直接 pecl uninstall swoole 或删掉 extension=swoole.so 并不能真正清理干净：残留的编译产物、共享对象、PHP 配置缓存都可能干扰后续安装。
- 先确认当前加载的是哪个
swoole.so：php --ri swoole | grep "swoole\.so"，记下完整路径（如/usr/lib/php/20220829/swoole.so） - 用
php-config --extension-dir查扩展目录，手动删除该swoole.so文件（别只注释extension=行） - 执行
phpenmod -r swoole（Debian/Ubuntu）或删掉/etc/php/*/mods-available/swoole.ini，避免配置残留 - 最后运行
php -m | grep swoole，输出为空才算卸载成功
从源码编译安装指定旧版本（最可靠方式）
PECL 默认只提供最新版，老版本（如 4.8.13、5.0.0-rc2）必须手动下载源码编译。跳过这步直接 pecl install swoole-4.8.13 很可能失败——PECL 仓库早已下线旧包。
- 去 GitHub 官方 Releases 页面下载对应 tag 源码：
wget https://github.com/swoole/swoole-src/archive/refs/tags/v4.8.13.tar.gz - 解压后进入目录，确保已安装
php-dev和gcc，然后按标准流程：phpize && ./configure && make && sudo make install - 检查生成的
swoole.so路径是否与php-config --extension-dir一致；若不一致，复制过去或调整extension_dir配置 - 重启 PHP-FPM 或 Apache，再用
php --ri swoole | grep Version验证版本号
为什么不能只换 swoole.so 文件？
常见错误现象：PHP Warning: Module 'swoole' already loaded in Unknown on line 0，或启动时报 undefined symbol: zend_string_init —— 这说明新旧扩展与 PHP 内核 ABI 不匹配。
- Swoole 扩展强依赖 PHP 的内部符号表和内存结构，不同 PHP 小版本（如
8.1.17vs8.1.25）甚至编译参数（ZTS/NTS）都会导致二进制不兼容 - 你手头的旧
swoole.so若是为 PHP 8.0 编译的，强行塞进 PHP 8.1 环境里，大概率直接段错误（Segmentation fault） - 务必用当前正在运行的 PHP 版本执行
phpize，且全程使用同一套php-config，否则就是埋雷
回滚后必须验证的三个关键点
装完旧版不是终点，协程、HTTP 服务、定时器这些核心能力在旧版中行为差异极大，不验证等于没回滚。
- 跑一个最小协程测试：
go(function () { echo "OK\n"; });，若报Call to undefined function go()，说明扩展未加载或版本太低（<4.4.0不支持全局go） - 启动一个 HTTP server，用
curl http://127.0.0.1:9501测试能否响应；Swoole\Http\Server在4.x和5.x的on('request')回调签名有变化，旧代码可能因参数错位崩溃 - 检查日志中是否有
WARNING swManager_check_exit_status: worker#0 abnormal exit, status=0, signal=11—— 这是典型的 ABI 不兼容导致的 core dump，得立刻停用并重编译
真正的难点不在“怎么装旧版”，而在于旧版是否还撑得住你的业务逻辑。比如 Swoole 4.8 不支持 HTTP/3，5.0 移除了 Coroutine::create()，这些 API 断层不会报错，但会在某个深夜的支付回调里静默失效。
