EMQ X MQTT 5.0 服务器的保留消息与消息过期间隔

保留消息

服务端收到 Retain 标志为 1 的 PUBLISH 报文时，会将该报文视为保留消息，除了被正常转发以外，保留消息会被存储在服务端，每个主题下只能存在一份保留消息，因此如果已经存在相同主题的保留消息，则该保留消息被替换。

当客户端建立订阅时，如果服务端存在主题匹配的保留消息，则这些保留消息将被立即发送给该客户端。借助保留消息，新的订阅者能够立即获取最近的状态，而不需要等待无法预期的时间，这在很多场景下非常重要的。

保留消息虽然存储在服务端中，但它并不属于会话的一部分。也就是说，即便发布这个保留消息的会话终结，保留消息也不会被删除。删除保留消息只有两种方式：

1. 客户端往某个主题发送一个 Payload 为空的保留消息，服务端就会删除这个主题下的保留消息。
2. 如果包含保留消息的 PUBLISH 报文设置了消息过期间隔属性，那么保留消息在服务端存储超过过期时间后就会被删除。

消息过期间隔

PUBLISH 报文可以设置消息过期间隔这一属性，消息过期间隔是一个四字节的整数，表示应用消息的生命周期，单位是秒。

如果 PUBLISH 报文不设置消息过期间隔，那么应用消息不会过期。

如果 PUBLISH 报文设置了消息过期间隔，并且消息过期将已经过期，服务端还没开始向匹配的订阅者交付该消息，那么服务端必须删除该消息。

EMQ X MQTT 服务器的保留消息

EMQ X MQTT Broker 的保留消息功能是由 emqx_retainer 插件实现，该插件默认开启，通过修改 emqx_retainer 插件的配置，可以调整 EMQ X Broker 储存保留消息的位置，限制接收保留消息数量和 Payload 最大长度，以及调整保留消息的过期时间。

emqx_retain