OctoPrint中禁用SD卡支持后无法多文件上传的问题解析

问题背景

OctoPrint作为一款流行的3D打印机控制软件，提供了丰富的功能选项供用户自定义。其中"上传到SD卡"（即Gcode流式传输）功能虽然实用，但部分用户反映会误触该按钮导致长时间等待。为此，用户可以通过取消勾选"启用SD支持"选项来隐藏该功能按钮。

问题现象

当用户在OctoPrint设置中禁用SD卡支持功能后，发现原本可用的多文件批量上传功能也随之失效。具体表现为：

1. 启用SD支持时：可同时上传多个.gcode文件
2. 禁用SD支持后：只能单文件上传

技术分析

该问题源于OctoPrint前端代码中的一个逻辑缺陷。在1.9.3版本中，文件上传处理逻辑与SD卡支持功能存在不当耦合：

1. 多文件上传功能原本应独立于SD卡支持功能
2. 但在代码实现中，多文件上传的处理流程被错误地包含在SD卡支持相关的条件判断中
3. 当SD支持被禁用时，整个多文件上传的处理分支也被跳过

解决方案

开发团队已识别并修复了该问题，主要修改包括：

1. 解耦多文件上传与SD卡支持功能的关联
2. 确保无论SD卡支持是否启用，都能正常处理多文件上传
3. 保持原有SD卡相关功能的独立性

版本更新

该修复已包含在以下版本中：

• 1.10.1稳定版（通过向后移植）
• 1.11及后续版本

用户建议

对于遇到此问题的用户，建议：

1. 升级到1.10.1或更高版本
2. 如需继续使用1.9.x版本，可暂时保持SD卡支持功能启用
3. 注意检查更新日志以获取最新修复信息

此问题的修复体现了OctoPrint团队对用户体验的持续关注，确保功能定制不会意外影响其他核心操作流程。