Swoole4加载失败主因是加载顺序错误、重复加载或扩展冲突，需确保extension=swoole.so置于所有相关扩展之前，禁用禾匠swoole_loader及旧版残留，并通过三步法验证真实加载状态。
加载 Swoole4 扩展时出现“Module 'swoole' already loaded”或函数找不到（如 swoole_version() 报错），通常不是没装上，而是加载顺序错、重复加载或与其他扩展冲突。关键不在重装，而在理清加载链路和互斥关系。
加载顺序必须满足：先 swoole.so，后其他依赖它的扩展
Swoole4 是底层 Zend 扩展，需在任何基于它的扩展（如 swoole_loader、think-swoole 的运行时组件）之前加载。PHP 按 php.ini 中 extension= 行的顺序依次载入，顺序错误会导致初始化失败或符号未定义。
- 打开你的
php.ini（CLI 和 FPM 各自一份），确认extension=swoole.so出现在所有其他 Swoole 相关扩展之前 - 尤其注意避开
extension=swoole_loader_20_php72.so这类禾匠系 loader —— 它和原生swoole.so不能共存，且 loader 必须放在 swoole 之后才可能生效（但实际仍冲突） - 如果用了
zend_extension类型的扩展（如 opcache、xdebug），它们与extension不同类，不参与此顺序，但需确保没禁用dl()或限制动态加载
两类典型冲突必须手动隔离
Swoole4 的运行环境对“纯净性”要求高，以下两类扩展一旦共存，必然报错：
Swoole 6.1.1
下载
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。
-
禾匠 swoole_loader：它本质是加密运行时补丁，会劫持 PHP 的 opcode 加载流程，与 Swoole4 的协程调度器、内存管理机制直接冲突。哪怕只在 php.ini 里写了一行
extension=swoole_loader_20_php74.so，也会导致php -m显示swoole，但运行时抛出Class not found或段错误 -
旧版 Swoole（2.x/3.x）残留：宝塔面板升级 PHP 版本后，旧版
swoole.so可能仍留在extensions/目录下，而新php-config指向的却是旧路径。执行php --ri swoole显示版本为 3.4.0，说明加载了旧库 —— 此时需手动删掉旧.so文件，并确认extension_dir指向正确目录
验证加载是否真正生效的三步法
别只看 php -m | grep swoole，它只说明模块名被识别，不等于功能可用：
- 第一步：查实际加载路径
php --ini | grep "Loaded Configuration File"→ 得到 CLI 的 php.ini 路径ps aux | grep php-fpm | grep -v grep→ 找到 fpm 进程，再查其配置：cat /proc/$(pgrep php-fpm)/environ | tr '\0' '\n' | grep PHP_INI_SCAN_DIR或直接看宝塔中 FPM 对应的 php.ini 路径 - 第二步：确认 .so 文件存在且权限正常
根据php-config --extension-dir输出的路径，检查该目录下是否有swoole.so，且属主为 root、权限为 644 - 第三步：运行时检测真实状态
写一个测试脚本：<?php var_dump(function_exists('swoole_version'), extension_loaded('swoole'));
CLI 下执行它；再通过 Web 访问同一脚本 —— 两者结果必须一致，否则就是 CLI/FPM 配置没同步
disable_functions 是隐形杀手
很多生产环境为安全起见，在 php.ini 中禁用了大量函数，而 Swoole4 启动时依赖 pcntl_fork、posix_getpid、stream_socket_pair 等底层系统调用。即使扩展加载成功，这些函数被禁也会导致 swoole_http_server 构造失败或协程无法调度。
- 检查
php -i | grep disable_functions，确认列表中不含上述函数 - 特别注意：Swoole4 在 PHP 8.0+ 中默认启用协程 DNS，若
gethostbyname被禁，Co::dnsLookup就会静默失败 - 临时调试可注释掉
disable_functions行，验证后再按需放开必要函数
