开源版5.8.9版本conf load热加载配置文件是否会对已建立的存量TCP长连接造成影响?

EMQX
,
1

开源版5.8.9版本
修改dashboard.swagger_support值之后通过conf load --replace /etc/emqx/emqx.conf,是否会对已建立的存量TCP长连接造成影响.比如批量掉线之类的情况?

2

只改 dashboard.swagger_support 不会让现有 MQTT/TCP 长连接批量掉线。这个配置只控制 Dashboard 的 Swagger UI；应用配置时不会重启 MQTT TCP listener，也不会重启 Broker。

但是 --replace：它会按传入文件替换现有运行时配置，并把变更同步到集群其他节点。如果 /etc/emqx/emqx.conf 里还包含 listener、认证、授权、zone 等其他差异，那些差异也会一起生效，影响就不再局限于 Swagger。

只改这一项，强烈建议用最小配置配合 --merge： ；默认也是 merge，而不是 replace 的

cat >/tmp/dashboard.hocon <<'EOF'
dashboard {
  swagger_support = false
}
EOF

emqx ctl conf load --merge /tmp/dashboard.hocon
emqx ctl conf show dashboard.swagger_support

执行后现有 MQTT/TCP 连接应保持不变，变化只是 /api-docs 的 Swagger 页面被关闭。若必须用 --replace /etc/emqx/emqx.conf，先确认该文件和当前运行时配置没有其他差异，再在非高峰期操作。

3

收到，感谢解答。