PHP 8.3 必须使用 Swoole 5.1.x（如 5.1.1 或 5.1.5），Swoole 4.8.13 不兼容且会导致扩展不加载或报错；安装需确认 pecl 和 php-config 版本一致，FPM 模式下手动配置 extension=swoole.so 并调用 Swoole\Runtime::enableCoroutine() 启用协程。
PHP 8.3 必须用 Swoole 5.1.x，别试 4.8.13
PHP 8.3 下唯一稳定可用的 Swoole 版本是 Swoole 5.1.x（比如 5.1.1 或 5.1.5），Swoole 4.8.13 是最后一个支持 PHP 7.4 的版本，它在 PHP 8.3 上会直接不加载，或报 Module 'swoole' already loaded 这类错误。这不是配置问题，是底层 API 兼容性断裂。
常见误判点：
- 看到“4.8.x 支持 PHP 8.0+”就往 8.3 上硬装——错，那是针对 PHP 8.0/8.1 的兼容范围，不是跨主版本通用
- 用
pecl search swoole看到一堆 4.x 版本，就默认选最新 4.x——实际pecl list里显示的 4.8.13 在 PHP 8.3 下根本不会注册成功 - 宝塔软件商店里没标“PHP 8.3 专用”，但点了安装——部分旧版宝塔未过滤版本适配，可能静默装错
PHP 8.0/8.1/8.2 推荐 Swoole 4.8.13 或 5.0.x
PHP 8.0 到 8.2 的主力稳定版本仍是 Swoole 4.8.13，它经过大量生产环境验证，协程、HTTP Server、WebSocket 行为确定；Swoole 5.0.x 可用，但部分边缘场景（如某些 OpenSSL 握手组合）偶有回归，建议等 5.1.0+ 再升。
判断依据很实在：
立即学习“PHP免费学习笔记（深入）”；
-
php -v输出主版本后，查 Swoole 官方 Release 页面 对应的 “Supported PHP versions” 栏 - 不要信第三方博客写的“已测试兼容”，只认 GitHub tag 页右上角明确写的 PHP 版本范围
- 宝塔用户：如果面板里 PHP 8.0 的 Swoole 选项是灰色不可点，说明该版本已下架——不是故障，是官方主动剔除不兼容项
pecl install swoole 默认装的是什么？
pecl install swoole 在 PHP 8.3 环境下默认拉取的就是 5.1.x，但前提是你的 pecl 是当前 PHP 版本自带的（即由 /www/server/php/83/bin/pecl 启动，而非系统全局 /usr/bin/pecl）。路径错，就会装成老版本。
执行前必须确认：
-
which pecl输出路径是否含/83/bin/（宝塔）或~/.phpenv/versions/8.3.0/bin/pecl（phpenv） -
pecl config-get php_ini返回的配置路径，是否和php --ini一致 - 装完后立刻运行
php --ri swoole | grep Version，输出必须是5.1.开头，不是4.8.
Windows 和 Alpine 镜像要额外盯住二进制兼容性
Windows 下没有 pecl install，只能下预编译 DLL：swoole-5.1.5-8.3-ts-vs16-x64.dll 这种文件名里的 ts（线程安全）、vs16（Visual Studio 2019 编译器）、x64 必须和你的 php -i | grep "Thread Safety" 和 Architecture 完全一致，差一个字母就 PHP Startup: Unable to load dynamic library。
Alpine 镜像（比如 php:8.3-alpine）更麻烦：
- musl libc 不兼容 glibc 编译的 .so，所以不能直接用 pecl 装，必须用
apk add php83-swoole（如果镜像源提供） - 若需自定义编译，得先
apk add pcre2-dev openssl-dev，且 configure 时加--enable-openssl --with-openssl-dir=/usr -
php --ri swoole成功不代表能跑 HTTPS——Alpine 的 OpenSSL 默认不带 TLS 1.3 支持，得手动补openssl1.1-compat
