NetAlertX 插件在 Ingress 模式下的下拉菜单问题解析

问题背景

NetAlertX 是一款网络监测工具，在 Home Assistant 的插件版本中，用户报告了一个关于 Ingress 模式下下拉菜单无法正常显示的问题。当用户尝试在设备管理界面使用下拉菜单时，发现菜单内容无法正常加载，而直接访问（非 Ingress 模式）则工作正常。

问题现象

在非 Ingress 模式下，设备管理界面中的下拉菜单能够正常显示所有选项内容。然而，在启用 Ingress 模式后，这些下拉菜单变成了空状态，无法显示任何选项。这导致用户无法通过界面进行相关配置操作。

技术分析

经过开发者调查，这个问题与 Ingress 模式下的 URL 字符处理机制有关。Ingress 作为 Home Assistant 的反向代理，会对某些特殊字符进行过滤或转义处理，这可能导致前端 JavaScript 无法正确解析从后端获取的下拉菜单数据。

具体表现为：

1. 前端 AJAX 请求能够成功发送
2. 后端也返回了正确的数据
3. 但在数据渲染阶段，由于 URL 编码/解码问题，导致下拉菜单内容无法正确显示

解决方案

开发团队通过以下步骤解决了这个问题：

1. 对前端代码进行了修改，确保在 Ingress 模式下正确处理 URL 编码
2. 更新了后端 API 接口，使其能够兼容 Ingress 的特殊字符处理要求
3. 发布了新版本(v24.1.19)修复此问题

版本管理注意事项

在修复过程中，开发团队曾不小心发布了版本号降级的更新(v25.1.8 → v24.1.19)。这提醒我们在版本管理中需要注意：

1. 遵循语义化版本控制规范
2. 发布前仔细检查版本号
3. 重大变更应该增加主版本号

结论

通过这次问题的解决，NetAlertX 插件在 Ingress 模式下的兼容性得到了提升。这也为其他类似插件的开发提供了经验：

1. 在开发支持 Ingress 的插件时，需要特别注意 URL 处理
2. 前端和后端都需要针对 Ingress 模式进行特殊处理
3. 完善的测试流程能够帮助及早发现问题

目前该问题已在新版本中得到修复，用户可以正常使用 Ingress 模式下的所有功能。