Swoole HTTP Server启动失败主因是端口占用或权限不足，开发用≥1024端口，HTTPS需显式配置SSL，协程中禁用同步IO须改用协程客户端，swoole_table键名大小写敏感且结构不可变，reload不清理onStart定时器需移至onWorkerStart。
PHP中swoole_http_server启动失败：常见报错和权限陷阱
直接跑不起来，八成不是代码问题，而是环境或权限卡住。最典型的是Address already in use或Permission denied——前者说明端口被占（比如Nginx、Apache或另一个Swoole进程正监听80/443），后者常出现在非root用户尝试绑定1024以下端口时。
实操建议：
- 先用
lsof -i :9501（或你设的端口）查端口占用，别盲目重启服务 - 开发阶段一律用≥1024的端口（如
9501），避免sudo启动；上线再配反向代理（Nginx转127.0.0.1:9501） -
swoole_http_server默认不支持HTTPS，想用https://必须加ssl配置项并传入证书路径，否则会静默降级为HTTP甚至启动失败
协程里调用file_get_contents或curl_exec阻塞整个服务？
这是新手掉进最多的一类坑：在Swoole\Coroutine上下文中，仍用同步IO函数，结果一个慢请求拖垮全部并发连接。
原因很直接：file_get_contents和原生curl_exec是阻塞式系统调用，协程无法自动挂起它们。
立即学习“PHP免费学习笔记（深入）”；
正确做法：
- 改用
Swoole\Coroutine\Http\Client发HTTP请求，它天生协程友好 - 读本地文件优先用
Swoole\Coroutine\FileSystem的readFile，比fopen安全 - 绝对不要在协程里
sleep(3)，要用Swoole\Coroutine::sleep(3)，否则整个worker进程停摆
swoole_table存数据为什么查不到？结构定义和键名大小写敏感
swoole_table不是普通数组，它是共享内存结构，初始化时字段类型、长度、是否允许NULL都得一次性定死，改不了；而且set和get的键名区分大小写，$table->set('User', [...])和$table->get('user')完全不匹配。
典型错误现象：get返回false但没报错，count()始终为0。
检查要点：
- 创建表时
new Swoole\Table(1024)的参数是「行数上限」，不是内存大小，别设太小导致写满后静默丢弃 - 字段定义必须用
$table->column('uid', Swoole\Table::TYPE_INT, 8)，其中8是字节数（INT通常填4或8），填错会导致读写错位 - 字符串字段长度要包含末尾
\0，比如存"admin"（5字符），column('name', TYPE_STRING, 6)才安全
reload后定时器Swoole\Timer::tick还在跑？热更不清理旧定时器
kill -USR1或server->reload()只重启worker进程，但主进程里注册的定时器不会自动销毁——尤其当你在onStart里写了Timer::tick，每次reload都会叠加一个新定时器，内存泄漏+CPU飙高。
根本原因：定时器ID只在当前进程有效，reload后旧进程已死，但没人主动调Timer::clear。
稳妥做法：
- 所有
Timer::tick或after都放在onWorkerStart里，而不是onStart，确保每个worker独立管理自己的定时任务 - 如果必须全局定时（如每分钟清缓存），改用
pcntl_signal+pcntl_alarm，或交给外部任务调度器（如Supervisor + cron） - 调试时加
echo "timer started, pid=".getmypid()."\n"，一眼看出是不是重复注册
协程切换、内存共享、信号处理——这些不是语法糖，是运行时模型的根本变化。写完go(function(){})不能只看它“跑起来了”，得确认它真在协程里跑，而不是退化成同步调用。这点最容易被忽略，也最难事后排查。
