Swoole服务在Docker中启动失败主因是环境配置错误：PHP与swoole版本ABI不匹配、缺失php-dev/gcc等构建依赖、未禁用opcache.enable_cli、daemonize=true导致进程退出，或Alpine镜像缺libgcc等系统库。
Swoole 服务在 Docker 中跑不起来，大概率不是 Swoole 本身的问题，而是容器环境缺失关键依赖或配置错位。
为什么 swoole.so 在容器里提示 “undefined symbol: zend_string_init”
这是典型的 PHP 扩展与 PHP 运行时 ABI 不匹配——你用的 swoole.so 是为 PHP 8.1 编译的，但容器里跑的是 PHP 8.2（或反过来）。
- 检查容器内 PHP 版本：
php -v，再查扩展编译版本：php --ri swoole | grep "Version" - 不要直接拷贝宿主机的
swoole.so进容器；应在 Dockerfile 中用pecl install swoole动态编译（确保php-dev和gcc已安装） - 若用 Alpine 镜像，必须加
apk add --no-cache $PHPIZE_DEPS，否则pecl会静默失败
Docker 启动 Swoole HTTP Server 后立刻退出
根本原因是 Swoole 的 Swoole\Http\Server 是常驻进程，而 Docker 默认以命令执行完即退出。没做前台运行控制，容器就“启动即死”。
- 必须用
exec启动：在启动脚本末尾写exec php server.php，避免 shell 进程成为 PID 1 后被信号中断 - 禁用
daemonize => true—— 容器不需要后台化，反而会导致主进程退出、子进程被 init 接管后失控 - 加上
restart: always只是兜底，不能替代正确启动方式
容器内 Co::sleep() 不生效或报错 “cannot use coroutine in sync mode”
协程函数只能在协程上下文中调用。Docker 环境本身不影响协程逻辑，但常见误配会让协程调度器未启用。
- 确认启动的是协程模式服务器（如
Swoole\Coroutine\Http\Server），不是传统Swoole\Http\Server - 检查
cli模式下是否手动启用了协程调度器：Swoole\Coroutine::set(['hook_flags' => SWOOLE_HOOK_ALL]) - Alpine 镜像默认不启用
libgcc的 stack unwinding 支持，可能导致协程切换异常；加apk add libgcc补齐
真正卡住人的，往往不是 Swoole 多难，而是容器里少装了一个 libgcc，或启动时多写了一个 daemonize => true —— 这些细节在本地开发时被掩盖，在 CI 或生产容器里才突然爆发。
