AList项目中蓝奏云优享版小文件上传问题的分析与解决方案

问题背景

在AList v3.37.4版本中，用户发现使用蓝奏云优享版存储驱动时，上传小于1.3KB的小文件以及空文件会出现失败的情况。具体表现为：

• 通过rclone挂载WebDAV上传时，系统返回"405 Method Not Allowed"错误
• 通过Web界面上传时，提示"-1: 未读取到文件大小"

问题分析

经过技术团队深入调查，发现问题根源在于AList与蓝奏云优享版API的交互过程中。具体表现为：

1. 当文件大小小于1KB时，AList向蓝奏云优享版的/7n/getUpToken接口发送请求时，传参中的fileSize会被计算为0
2. 蓝奏云优享版API对文件大小的处理采用向上取整到KB的方式，但当前实现方式不够严谨
3. 当文件大小为0时，蓝奏云服务器会拒绝请求，导致上传失败

技术细节

蓝奏云优享版API在计算文件大小时，采用将字节数转换为KB数的处理逻辑。原始实现中，对于小文件的处理存在以下问题：

1. 直接除法计算会导致小于1KB的文件被计算为0KB
2. 简单的+1处理方式在文件大小恰好是1024字节的整数倍时会产生不准确的结果

解决方案

经过技术验证，最优解决方案是采用以下计算方式：

max(1, (文件字节数 + 1023) / 1024)

这种实现方式具有以下优势：

1. 确保任何非空文件至少计算为1KB
2. 对于1024字节整数倍的文件也能准确计算
3. 符合蓝奏云优享版API的预期处理逻辑

验证结果

技术团队对修复方案进行了全面测试：

1. 成功上传了0字节的空文件
2. 上传了1KB以下的各类小文件
3. 测试了1024字节整数倍的特殊情况
4. 验证了大文件上传不受影响

所有测试用例均通过，问题得到彻底解决。

最佳实践建议

对于AList用户使用蓝奏云优享版存储时，建议：

1. 及时更新到包含此修复的版本
2. 对于关键业务场景，建议在上传前检查文件大小
3. 考虑对极小文件采用压缩或合并策略，提高存储效率

此问题的解决不仅修复了当前的上传故障，也为AList与各类云存储API的交互提供了更健壮的处理模式。