要让swoole4协程mysql客户端稳定运行，必须启用协程运行时、正确初始化连接对象、严格校验连接结果；需在脚本开头调用swoole\runtime::enablecoroutine()，确保配置完整且端口为整数，连接后检查$database->connected并定期ping探活。
要让 Swoole4 协程 MySQL 客户端稳定运行不报错，核心是三点：启用协程运行时、正确初始化连接对象、严格校验连接结果。很多报错（比如 connect_error 为空、call to a member function query() on null）都源于这三步中的疏漏。
必须启用协程运行时
Swoole 4.0+ 的协程 MySQL 客户端依赖全局协程环境。如果没开启，所有协程 API（包括 Swoole\Coroutine\MySQL）会退化为同步阻塞行为，甚至直接抛出致命错误或静默失败。
- 在脚本最开头（任何协程操作之前）调用：
Swoole\Runtime::enableCoroutine(); - 不需要额外设置
hook_flags，默认已启用 MySQL hook；但若混用其他 IO（如 curl、file_get_contents），可显式指定：Swoole\Runtime::enableCoroutine(SWOOLE_HOOK_ALL); - 切勿在
onRequest或onReceive回调里重复启用——只执行一次即可
创建连接前先检查配置项完整性
连接参数缺失或类型错误会导致 connect() 返回 false，但不抛异常，容易被忽略。
- 必需字段一个都不能少：
host、port、user、password、database -
port必须是整数，不能是字符串"3306"；database名称需真实存在，否则连接成功但后续查询报错 - 建议显式设置
charset（如"utf8mb4"），避免因服务端默认字符集不一致引发乱码或插入失败 - 示例安全写法：
$db = new Swoole\Coroutine\MySQL();<br>$result = $db->connect([<br> 'host' => '127.0.0.1',<br> 'port' => 3306,<br> 'user' => 'root',<br> 'password' => 'your_pass',<br> 'database' => 'test',<br> 'charset' => 'utf8mb4'<br>]);<br>if (!$result) {<br> throw new RuntimeException('MySQL connect failed: ' . $db->connect_error . ' (' . $db->connect_errno . ')');<br>}
连接后务必验证对象状态再使用
即使 connect() 返回 true，也不能保证后续操作一定成功。网络抖动、超时、权限变更都可能导致连接中途失效。
- 每次执行
query()或execute()前，建议检查$db->connected === true - 对关键查询加
try-catch捕获Swoole\Coroutine\MySQL\Exception（Swoole 4.5+ 支持） - 长生命周期协程中（如定时任务），定期调用
$db->ping()探活；返回false时应主动重建连接 - 避免复用跨协程的
$db实例——每个协程应持有独立连接，或通过连接池统一管理
不复杂但容易忽略。
