AList项目中蓝奏云优享版小文件上传问题的技术分析

问题背景

在AList项目（一个支持多种云存储的网盘聚合工具）中，用户反馈使用蓝奏云优享版存储驱动时，上传小于1.3KB的小文件或空文件会出现失败的情况。具体表现为：

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

问题定位

经过技术分析，发现问题出在获取上传令牌的接口调用环节。当用户尝试上传小文件时，AList会向蓝奏云优享版的/7n/getUpToken接口发起请求，该接口需要传入文件大小参数。

关键发现：

1. 当文件大小小于1KB（1024字节）时，AList会将该值直接传递给接口
2. 蓝奏云优享版后端在处理该参数时，预期接收的是以KB为单位的文件大小
3. 对于小于1KB的文件，直接传递字节数会导致接口返回错误

技术原理

蓝奏云优享版的/7n/getUpToken接口实现了一个特殊逻辑：它要求文件大小参数必须以KB为单位，并且采用向上取整的计算方式。例如：

• 0字节 → 1KB
• 1字节 → 1KB
• 1024字节 → 1KB
• 1025字节 → 2KB

AList当前实现中直接将字节数传递给接口，没有进行单位转换，这导致了小文件上传失败的问题。

解决方案

经过技术验证，提出了两种可行的修复方案：

1. 基础修复方案： 对文件大小进行简单的+1处理，确保任何非零文件至少被视为1KB

   文件大小(KB) = 原始字节数 + 1
   

2. 优化修复方案： 采用更严谨的向上取整计算方法，确保1024字节整数倍的情况也能正确处理

   文件大小(KB) = max(1, (原始字节数 + 1023) / 1024)
   

经过测试验证，两种方案都能解决小文件上传问题，但第二种方案在数学上更为严谨，能够处理所有边界情况。

实现建议

对于AList项目的维护者，建议采用第二种优化方案进行修复。这种实现方式：

• 完全符合蓝奏云优享版接口的预期
• 处理了所有可能的文件大小边界情况
• 保持了与官方客户端一致的行为
• 不会对正常大小的文件上传产生任何影响

该修复已在最新版本的AList中实现，用户升级后即可解决小文件上传问题。