连接超时（connection_timeout）应设为float类型，推荐3.0–5.0秒；它仅控制TCP握手阶段等待时间，与heartbeat无关，且必须显式写成3.0而非3。
php-amqplib 连接超时怎么设？
连接超时（connection timeout）控制的是 TCP 握手阶段的最大等待时间，不是 AMQP 协议层的认证或频道建立耗时。它由底层 stream_socket_client() 决定，php-amqplib 通过 $connection_options['timeout'] 透传给它。
常见错误是把 timeout 设成浮点数却没加小数点（如写 5 而非 5.0），PHP 会当整型传入，某些版本下被忽略；还有人误以为设了 heartbeat 就能替代连接超时，其实两者完全无关。
-
timeout必须是 float 类型，推荐显式写成5.0、10.0 - 值过小（如
0.1）可能导致偶发性连接失败，尤其在高延迟网络或 DNS 解析慢时 - 该参数只影响初始连接，不控制后续读写阻塞
$connection = new \PhpAmqpLib\Connection\AMQPStreamConnection(
'localhost',
5672,
'guest',
'guest',
'/',
false,
'AMQPLAIN',
null,
'en_US',
30.0, // connection_timeout: float, 单位秒
3.0 // read_write_timeout: float, 单位秒（可选，不设则默认为 timeout 值）
);
心跳间隔（heartbeat）必须和服务端一致吗？
必须。AMQP 协议要求客户端声明的心跳间隔不能大于服务端配置的 heartbeat 值，否则 RabbitMQ 会拒绝连接并返回 connection.close 错误，消息里通常含 FRAME_ERROR 或明确提示 heartbeat miss。
服务端默认 heartbeat 是 60 秒（RabbitMQ 3.8+），但很多生产环境会调低到 30 或 10 秒。php-amqplib 的 heartbeat 参数对应 AMQP Connection.Start-Ok 中的 heartbeat 字段，不是 TCP keepalive。
立即学习“PHP免费学习笔记（深入）”；
- 客户端设
heartbeat => 0表示禁用心跳（不推荐，NAT/防火墙易断连） - 设
heartbeat => 30时，客户端每 30 秒发一次AMQPHeartbeatFrame，服务端也按此周期检测 - 实际心跳帧发送间隔 ≈
heartbeat / 2（库内部实现策略，避免同时发） - 若服务端配置
heartbeat = 10，客户端设20会被拒绝；设5则允许（服务端接受更激进的心跳）
read_write_timeout 和 heartbeat 有什么区别？
read_write_timeout 是 socket 级别的读写阻塞超时，影响 basic.get、wait()、consume() 等阻塞调用；heartbeat 是协议层保活机制，用于探测连接是否“活着”，不直接影响单次方法调用时长。
典型误用：有人想靠调大 heartbeat 来避免 AMQPTimeoutException，结果发现没用——那其实是 read_write_timeout 触发的。反过来，设了很小的 read_write_timeout（如 1.0），但 heartbeat 是 30，连接不会因心跳失败断开，只是每次 get() 超过 1 秒就抛异常。
-
read_write_timeout默认等于timeout，建议显式设置，尤其在长轮询场景 - 设为
0表示无限等待（危险，可能卡死进程） - 心跳失败触发的是连接级断开（
AMQPConnectionClosedException），不是超时异常
如何验证心跳和超时是否生效？
最直接的方式是抓包看 TCP 层和 AMQP 层行为：用 tcpdump 过滤端口，观察是否有周期性空帧（AMQP Heartbeat）；同时关掉 RabbitMQ 服务，看客户端是在 timeout 秒后报错，还是等满 read_write_timeout 才失败。
代码中可通过捕获异常类型区分问题来源：
-
AMQPConnectionClosedException→ 心跳失败或服务端主动关闭 -
AMQPTimeoutException→read_write_timeout触发（如channel->wait()卡住） -
ErrorException或RuntimeException含stream_socket_client(): unable to connect→timeout生效
注意：心跳检测本身不抛异常，它静默断开连接，下次操作时才暴露问题。所以真正要监控的是首次 channel->basic_get() 或 channel->wait() 的响应行为。
