Rclone项目中Backblaze B2远程存储大文件上传自定义头缺失问题分析

在Rclone项目中，用户在使用Backblaze B2远程存储上传大文件时发现了一个重要问题：通过--header-upload参数设置的自定义HTTP头信息无法正确应用于大文件（多部分上传）的场景，而小文件上传则能正常工作。

问题现象

当用户尝试使用如下命令上传大文件时：

rclone --header-upload "X-Bz-Info-Uncompressed-Size: 10000000000" --b2-upload-cutoff 6Mi --b2-chunk-size 6Mi copy 10megabyte-test-file b2:my-bucket

虽然命令执行成功，但通过HTTP HEAD请求检查上传后的文件时，发现自定义头X-Bz-Info-Uncompressed-Size并未出现在响应头中。相比之下，小文件上传时该头信息能够正确设置。

技术分析

深入分析Rclone源码后发现，问题根源在于大文件上传和小文件上传采用了不同的代码路径：

1. 小文件上传路径：通过Update()函数处理，该函数正确地将Options参数包含在Opts结构中，从而保证了自定义头信息的传递。

2. 大文件上传路径：通过newLargeUpload()函数处理，该函数在初始化上传操作时，没有将Options参数包含在Opts结构中，导致自定义头信息丢失。

解决方案

修复此问题需要修改newLargeUpload()函数，使其能够接收并处理options参数。具体修改包括：

1. 为newLargeUpload()函数添加options参数
2. 确保所有调用newLargeUpload()的地方都正确传递了options参数
3. 在Opts结构中正确设置Options字段

影响范围

此问题影响所有使用Rclone进行Backblaze B2大文件上传并需要设置自定义头信息的场景。特别是那些依赖自定义头信息（如X-Bz-Info-*系列头）来实现特定功能的用户。

技术建议

对于需要临时解决方案的用户，可以考虑以下替代方案：

1. 降低--b2-upload-cutoff参数值，强制使用小文件上传路径
2. 上传完成后通过API手动设置文件元数据

不过，这些方法都有其局限性，最佳解决方案还是等待官方修复并更新Rclone版本。

总结

这个问题展示了在文件上传功能中处理不同大小文件路径时容易出现的参数传递不一致问题。开发者在实现类似功能时，应当特别注意确保所有代码路径都能正确处理相同的参数集，避免因实现细节差异导致功能不一致。