Swoole服务端启动失败？如何排查故障及解决方法？

本文共计837个文字，预计阅读时间需要4分钟。

说明：

实操建议：

• 先运行 php -m | grep swoole，没输出就说明 CLI 环境根本没加载扩展
• 查 CLI 的配置文件位置：php --ini，重点关注 Loaded Configuration File 路径（比如 /etc/php/8.2/cli/php.ini）
• 确认 swoole.so 文件存在，再往对应 php.ini 里加一行：extension=swoole.so（不要写绝对路径，除非必要）
• 如果用了多版本 PHP（如 8.1/8.2 并存），注意 CLI 和 FPM 的 php.ini 是分开的，别改错文件

启动时提示 Address already in use

说明：端口被占是高频原因，尤其阿里云、腾讯云服务器上，可能已有 Nginx、另一个 Swoole 实例、甚至残留的僵尸进程在监听 9501 或你指定的端口。