Home Assistant操作系统SMB共享磁盘使用率统计异常问题分析

问题背景

近期在Home Assistant操作系统11.3版本升级后，用户报告了一个与SMB/CIFS共享存储相关的问题。当系统或应用程序(如Frigate)尝试通过shutil.disk_usage()或psutil.disk_usage()获取挂载的SMB共享磁盘使用情况时，会抛出"Resource temporarily unavailable"(资源暂时不可用)的错误，错误代码为EAGAIN(11)。

问题表现

1. 系统监控(SystemMonitor)组件无法获取挂载的SMB共享磁盘信息
2. Frigate等依赖磁盘使用率统计的应用出现功能异常
3. 通过命令行执行df等磁盘统计命令时同样报错
4. 值得注意的是，虽然统计功能失效，但实际的读写操作仍能正常进行

技术分析

经过深入调查，发现问题根源在于Linux内核6.1.70版本引入的一个变更。该变更原本是为了修复CIFS文件系统的其他问题，但在6.1.x内核分支中却导致了stat系列系统调用(包括statvfs)的异常行为。

具体表现为：

• 在6.1.70及更高版本的6.1.x内核中，对CIFS共享执行statvfs调用会返回EAGAIN错误
• 同样的变更在6.6.9内核中工作正常，说明问题特定于6.1.x分支的实现
• 该问题已被报告至Linux内核稳定版维护团队

影响范围

• 使用Home Assistant OS 11.3(搭载Linux 6.1.70内核)并挂载SMB/CIFS共享的用户
• 任何依赖磁盘使用率统计的功能或应用都会受到影响

临时解决方案

对于急需解决问题的用户，目前有以下几种临时解决方案：

1. 降级到Home Assistant OS 11.3.rc1版本(使用6.1.69内核)：

   ha os update --version 11.3.rc1
   

2. 将共享协议从SMB/CIFS切换为NFS(如果NAS设备支持)

3. 对于不依赖磁盘统计功能的应用，可以继续使用，因为实际的文件操作不受影响

长期解决方案

Linux内核团队正在处理此问题，预计将在未来的内核更新中修复。Home Assistant操作系统团队也会在修复可用后及时发布包含修复的更新版本。

技术建议

对于开发者：

• 在使用磁盘统计功能时增加适当的错误处理和重试机制
• 考虑为关键功能提供替代方案，如允许手动指定磁盘容量

对于高级用户：

• 可以监控内核更新状态，关注相关修复的进展
• 在升级前检查已知问题，避免生产环境受到影响

总结

这个问题展示了即使是经过严格测试的LTS内核版本，也可能在特定场景下出现回归问题。对于智能家居系统这类需要长期稳定运行的环境，建议：

1. 在非关键系统上先行测试主要更新
2. 保持对系统日志的定期检查
3. 了解系统的回滚机制，以便在出现问题时快速恢复

随着开源社区的协作，预计这个问题将很快得到解决，届时用户可以安全升级到修复后的版本。