Symbol lookup error是动态链接失败，因swoole.so依赖的C函数符号（如SSL_get1_peer_certificate）缺失，常见于OpenSSL、nghttp2等库版本不匹配或未安装对应开发包。
php 启动时报 Symbol lookup error 是什么问题
这不是 PHP 代码错误，是动态链接失败——php 进程加载 swoole.so 时，找不到它依赖的某个 C 函数符号（比如 SSL_get1_peer_certificate、nghttp2_session_set_local_window_size 等）。常见于 OpenSSL、nghttp2、zlib 版本不匹配或未安装对应开发包。
怎么快速定位缺失的符号和库
别猜，直接用系统工具查：
- 运行
php -v，如果报Symbol lookup error，立刻停住，不要继续跑业务代码 - 执行
ldd $(php-config --extension-dir)/swoole.so | grep "not found"，看哪些.so文件标红（not found） - 若没标红但仍有错误，加
-r参数查运行时依赖：LD_DEBUG=libs php -v 2>&1 | grep -i "swoole\|ssl\|http2\|zlib" - 重点关注：libssl.so.1.1（或 .3）、libnghttp2.so、libz.so、libbrotlidec.so —— 这些是 Swoole 5.x 常依赖项
Ubuntu/Debian 和 CentOS 的修复差异
不同发行版装的库名、路径、版本策略不同，硬套命令会翻车：
Swoole 6.1.1
下载
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。
- Ubuntu 22.04+ / Debian 12：默认用 OpenSSL 3.x，但 Swoole 4.8–5.0.x 多数只兼容 OpenSSL 1.1；装
libssl1.1包（非libssl-dev），再软链：sudo ln -sf /usr/lib/x86_64-linux-gnu/libssl.so.1.1 /usr/lib/libssl.so - CentOS 7：自带 OpenSSL 1.0.2，Swoole 5.x 已不支持，必须升级系统或降级 Swoole 版本（如用
pecl install swoole-4.11.5） - Alpine：绝对不要用
pecl install编译；改用apk add php81-swoole（注意替换为你的 PHP 主版本号），musl libc 和 glibc ABI 不兼容，自己编译大概率静默失败 - 所有系统都要装开发头文件：
libssl-dev（Debian）、openssl-devel（CentOS）、openssl-dev（Alpine），否则./configure阶段就跳过 HTTPS/HTTP2 支持，但运行时仍可能因弱依赖出错
为什么 extension=swoole.so 写对了还是报错
因为 swoole.so 文件本身已损坏或 ABI 错配——不是配置问题，是二进制不兼容。典型表现：
-
php --ri swoole能显示模块信息，但php -r "new Swoole\Http\Server();"直接崩溃 - 同一台机器上，CLI 能用，FPM 就报 Symbol lookup error（说明两个 PHP 实例用了不同编译参数或不同 openssl 库路径）
- docker build 日志里有
Build complete，但最终容器里php -v报错 —— 构建阶段用的 base 镜像和运行时镜像 OpenSSL 版本不一致 - 解决方法只有一条：删掉现有
swoole.so，确认php-config --version和当前php -v主版本一致，再用对应phpize和--with-php-config重编译
最易被忽略的一点：某些云服务器（如阿里云、腾讯云）预装的 PHP 是自定义编译版，php-config 输出的 --extension-dir 路径下可能已有旧版 swoole.so，而你新编译的放在别处，PHP 默认优先加载旧的那个。务必用 strace php -v 2>&1 | grep swoole.so 看它实际 open 了哪个路径。
