Longhorn项目中的WebUI卷显示异常问题分析与解决

问题现象

在Longhorn 1.8.0版本中，用户报告了一个WebUI界面显示异常的问题。具体表现为：

1. 所有卷在WebUI中周期性消失和重现，间隔约几分钟
2. Dashboard显示"无卷"状态
3. 卷标签页内容间歇性空白
4. 搜索功能失效，即使卷显示时也无法通过名称搜索到

值得注意的是，通过kubectl命令行工具查询卷状态始终正常，所有卷都显示为"已附加"和"健康"状态。

问题背景

Longhorn是一个开源的云原生分布式块存储系统，专为Kubernetes设计。它提供了WebUI界面用于管理存储卷、节点等资源。这个问题出现在用户从1.7.2版本升级到1.8.0后，涉及27个存储卷的管理界面显示异常。

技术分析

日志分析

从系统日志中发现了几个关键线索：

1. 卷查找失败警告：控制器频繁记录无法找到卷的错误，即使卷实际存在

Cannot auto-delete Pod when the associated Volume is not found
volume.longhorn.io "zigbee2mqtt-config-pv" not found

2. WebSocket连接异常：出现大量WebSocket连接异常关闭的警告

websocket: close 1006 (abnormal closure): unexpected EOF

3. HTTP处理错误：存在HTTP连接中断的问题

writev tcp 10.42.10.50:9500->10.42.9.233:57680: writev: broken pipe

根本原因

经过深入分析，发现问题由两个独立因素导致：

1. 卷控制器逻辑缺陷：

   • 当用户通过UI创建卷但通过其他方式(如Flux/Kustomize)创建PV/PVC时
   • 控制器尝试通过PV名称而非CSI volumeHandle查找卷
   • 导致周期性出现"卷不存在"的错误日志
   • 这影响了WebUI获取卷列表的稳定性

2. WebUI搜索功能缺陷：

   • 前端搜索功能存在逻辑错误
   • 即使卷显示在列表中，也无法通过名称搜索到
   • 这是独立于第一个问题的UI缺陷

解决方案

卷控制器修复

开发团队提交了修复代码，主要改进点：

1. 修改控制器查找卷的逻辑
2. 优先使用CSI volumeHandle而非PV名称
3. 确保无论PV/PVC创建方式如何都能正确关联卷

该修复已通过以下测试场景验证：

1. CSI流程创建的卷
2. UI创建但通过其他方式配置PV/PVC的卷
3. 卷崩溃恢复场景
4. 自动删除工作负载Pod功能

WebUI搜索功能修复

前端团队针对搜索功能进行了修复：

1. 修正了名称匹配逻辑
2. 确保搜索功能在所有资源页面(卷、节点、实例管理器)正常工作
3. 优化了搜索结果的显示

影响评估

该问题主要影响用户体验，不会导致数据丢失或存储功能异常。修复后：

1. WebUI卷列表显示稳定
2. 搜索功能恢复正常
3. 控制器日志不再出现虚假错误

用户建议

遇到类似问题的用户可以：

1. 检查控制器日志确认是否出现相同错误模式
2. 临时使用kubectl命令行工具管理卷
3. 等待修复版本发布后升级

对于WebSocket连接问题，由于无法在测试环境中复现，建议用户：

1. 检查网络连接稳定性
2. 监控系统资源使用情况
3. 如问题持续，提供更详细的环境信息

总结

Longhorn团队通过深入分析日志和代码，识别并修复了WebUI显示异常的问题。这体现了开源社区对用户体验的重视和快速响应能力。用户升级到包含修复的版本后，将获得更稳定的存储管理体验。