Add #14957, #15073, #15106

Author: Meggielqk

en_US/changes/all-changes-ee.md

@@ -4,7 +4,7 @@ The release notes page for EMQX Enterprise provides a comprehensive and detailed
 
 ## v5.9
 
-- [5.9.0](./changes-ee-v5.md#_5-9-0): 2025-04-22
+- [5.9.0](./changes-ee-v5.md#_5-9-0): 2025-05-02
 
 ## v5.8
 

en_US/changes/breaking-changes-ee-5.9.md

@@ -6,4 +6,10 @@
   - This change is incompatible with versions prior to 5.1.0
   - This change is also incompatible with manually modified limiter configurations that use structures from versions prior to 5.1.0
   - The undocumented endpoint `/configs/limiter` has been removed
+  
 - [#14703](https://github.com/emqx/emqx/pull/14703) Changed the maximum allowed value for `force_shutdown.max_heap_size` to `128GB`.
+
+- [#14957](https://github.com/emqx/emqx/pull/14957) The way plugin configurations are updated has changed. The system now respects the result of the `on_config_changed` callback when updating a plugin's configuration. This change only affects new configuration updates made through the Dashboard. The result of the `on_config_changed` callback is still ignored for configurations that have already been stored in the cluster.
+
+  Additionally, plugin apps are now loaded during plugin installation to ensure the `on_config_changed` callback is called even for stopped plugins.
+

en_US/changes/changes-ee-v5.md

@@ -2,7 +2,7 @@
 
 ## 5.9.0
 
-*Release Date: 2025-03-25*
+*Release Date: 2025-05-02*
 
 Make sure to check the breaking changes and known issues before upgrading to EMQX 5.9.0.
 
@@ -156,6 +156,12 @@ Make sure to check the breaking changes and known issues before upgrading to EMQ
 
 - [#14647](https://github.com/emqx/emqx/pull/14647) `cluster.hocon` backups are now made at a configurable interval. Instead of create a backup for each single config update operation, now we collect several changes before backing the file up, reducing the number of such backups.
 
+#### Plugin and Extension
+
+- [#14957](https://github.com/emqx/emqx/pull/14957) Enhanced plugin configuration update handling:
+  - Added support for respecting the `on_config_changed` callback response for plugins. This ensures that when the configuration of a plugin is updated, the plugin’s callback is properly called to handle the change, even for stopped plugins.
+  - Introduced a new method for updating plugin configurations that respects the result of the `on_config_changed` callback.
+
 #### MQTT over QUIC
 
 - [#14583](https://github.com/emqx/emqx/pull/14583) QUIC listener now supports dumping TLS secrets to SSLKEYLOGFILE for traffic decryption.
@@ -192,6 +198,8 @@ Make sure to check the breaking changes and known issues before upgrading to EMQ
 
   Prior to this fix, the broker would accept `PUBACK` and `PUBREC`/`PUBCOMP` packets from clients referencing packet identifiers that corresponded to messages with QoS 2 and 1, respectively. Now, the broker will disconnect clients that behave like this.
 
+- [#15106](https://github.com/emqx/emqx/pull/15106) Fixed a bug where duplicated `clientid` values were being returned by the `GET api/v5/clients_v2` API. This issue occurred due to the accidental resurrection of `chaninfo` events, causing unexpected client data duplication. The fix ensures that such events do not inadvertently affect the client list, resolving the issue where clients appeared as duplicated on the client page.
+
 #### Installation
 
 - [#14624](https://github.com/emqx/emqx/pull/14624) Fixed macOS release package dynamic linking openssl.e
@@ -267,6 +275,10 @@ Make sure to check the breaking changes and known issues before upgrading to EMQ
 - [#14975](https://github.com/emqx/emqx/pull/14975) Fixed an issue preventing on-the-fly updates to certain TLS listener options, requiring a disable-enable cycle for changes to take effect.
 - [#15037](https://github.com/emqx/emqx/pull/15037) Fixed rate limiting for dynamicalley created zones. Previously, the rate-limiting was not applied if a zone was created after the EMQX node was started.
 
+#### Plugin and Extention
+
+- [#15073](https://github.com/emqx/emqx/pull/15073) Added a validator for the server URL in the `exhook` configuration. This ensures that only valid URLs can be saved. Invalid URLs will now trigger an error and prevent being saved, which helps avoid issues during the import process, where previously invalid URLs could be accepted.
+
 #### MQTT over QUIC
 
 - [#14775](https://github.com/emqx/emqx/pull/14775) QUIC Listener: Fixed issue where zone configurations are not applied after a config reload.

zh_CN/changes/all-changes-ee.md

@@ -4,7 +4,7 @@ EMQX 企业版版本发布页面全面详细地记录了 EMQX 企业版每个版
 
 ## v5.9
 
-- [5.9.0](./changes-ee-v5.md#_5-9-0): 2025-04-22
+- [5.9.0](./changes-ee-v5.md#_5-9-0): 2025-05-02
 
 ## v5.8
 

zh_CN/changes/breaking-changes-ee-5.9.md

@@ -8,3 +8,7 @@
   - 已移除未公开的配置接口 `/configs/limiter`。
 
 - [#14703](https://github.com/emqx/emqx/pull/14703) `force_shutdown.max_heap_size` 的最大允许值已更改为 `128GB`。
+
+- [#14957](https://github.com/emqx/emqx/pull/14957) 插件配置更新的方式已发生变化。系统现在会在更新插件配置时考虑 `on_config_changed` 回调的返回结果。此更改仅影响通过 Dashboard 进行的新配置更新。对于已经存储在集群中的配置，`on_config_changed` 回调的结果仍然会被忽略。
+
+  此外，现在插件安装过程中会加载插件应用，以确保即使是已停止的插件也能调用 `on_config_changed` 回调。

zh_CN/changes/changes-ee-v5.md

@@ -2,7 +2,7 @@
 
 ## 5.9.0
 
-*发布日期：2025-04-22*
+*发布日期：2025-05-02*
 
 升级前请查看已知问题列表和不兼容变更列表。
 
@@ -149,6 +149,12 @@
 
 - [#14647](https://github.com/emqx/emqx/pull/14647)  `cluster.hocon` 文件的备份现在支持通过可配置的时间间隔进行。此前每次配置变更都会创建一次备份，现在改为收集多个更改后再进行一次备份，以减少不必要的备份频率。
 
+#### 插件与扩展
+
+- [#14957](https://github.com/emqx/emqx/pull/14957) 增强了插件配置更新的处理：
+  - 增加了对插件 `on_config_changed` 回调响应的支持。确保在更新插件配置时，即使插件已停止，也能正确调用插件的回调来处理配置变化。
+  - 引入了一种新的插件配置更新方法，该方法会根据 `on_config_changed` 回调的结果来进行配置更新。
+
 #### MQTT over QUIC
 
 - [#14583](https://github.com/emqx/emqx/pull/14583) QUIC 监听器现在支持将 TLS 密钥导出至 `SSLKEYLOGFILE`，以便用于流量解密。
@@ -178,6 +184,7 @@
 - [#14707](https://github.com/emqx/emqx/pull/14707) 修复在启用 strict_mode 时，带有 DUP 标志的 QoS 2 PUBLISH 报文被错误地视为无效报文的问题。
 - [#14192](https://github.com/emqx/emqx/pull/14192) 修复由于认证/授权过期导致断开的客户端无法发送遗嘱消息的问题。此前由于遗嘱发送发生在权限过期之后，导致消息无法通过授权校验而被阻止。
 - [#14122](https://github.com/emqx/emqx/pull/14122) 修复当客户端错误地将 QoS 2 消息使用 PUBACK 响应，或将 QoS 1 消息使用 PUBREC/PUBCOMP 响应时，EMQX 未断开连接的问题。现在若客户端使用错误的应答流程，EMQX 将主动断开连接。
+- [#15106](https://github.com/emqx/emqx/pull/15106) 修复了 `GET api/v5/clients_v2` API 返回重复 `clientid` 值的 bug。该问题是由于 `chaninfo` 事件意外复活，导致客户端数据重复。修复确保此类事件不会无意中影响客户端列表，从而解决了客户端页面上出现重复客户端的情况。
 
 #### 安装部署
 
@@ -243,6 +250,10 @@
 - [#14975](https://github.com/emqx/emqx/pull/14975) 修复某些 TLS 监听器配置项无法热更新的问题。此前必须先禁用再启用监听器，才能使更改生效。
 - [#15037](https://github.com/emqx/emqx/pull/15037) 修复动态创建的 Zone 无法应用速率限制的问题。此前如果 Zone 在节点启动后创建，其速率限制配置不会生效。
 
+#### 插件与扩展
+
+- [#15073](https://github.com/emqx/emqx/pull/15073) 为 `exhook` 配置中的服务器 URL 添加了验证器。这样可以确保只有有效的 URL 能够被保存。无效的 URL 将触发错误并阻止保存，从而避免在导入过程中出现问题，以前无效的 URL 可能会被接受。
+
 #### MQTT over QUIC
 
 - [#14775](https://github.com/emqx/emqx/pull/14775) 修复配置热重载后 QUIC 监听器未正确应用 zone 配置的问题。