AList项目中华为云对象存储中文文件重命名问题解析

问题背景

在AList项目（一个支持多种存储协议的文件列表程序）中，用户报告了一个关于华为云对象存储(OBS)的特定问题：当尝试重命名包含中文字符的文件或文件夹时，系统会返回签名不匹配的错误。该问题在v3.39.1版本中被确认存在。

问题现象

用户在使用AList对接华为云OBS时发现：

1. 将英文名称改为中文名称可以成功
2. 但已经包含中文的文件名再次修改时会失败
3. 错误提示为"SignatureDoesNotMatch"，表明请求签名计算与服务端验证不匹配

技术分析

经过开发者排查，发现问题根源在于请求头中的X-Amz-Copy-Source字段处理不当。该字段用于标识需要重命名的源文件路径，但在包含中文字符时没有进行正确的URL编码转义。

在HTTP请求签名验证机制中，请求头的每个字段都会参与签名计算。当字段值包含特殊字符（如中文）而未转义时：

1. 客户端计算的签名是基于未转义的原始值
2. 服务端接收到的可能是转义后的值
3. 这种不一致导致签名验证失败

解决方案

开发者通过修改代码，确保在构造X-Amz-Copy-Source头时对路径中的中文字符进行正确的URL编码处理。这包括：

1. 对路径中的每个路径段分别进行编码
2. 保留路径分隔符"/"不变
3. 确保编码后的字符串与服务端的处理方式一致

技术原理深入

华为云OBS兼容AWS S3协议，使用基于HMAC的签名算法V4。签名过程涉及：

1. 规范化请求（Canonical Request）构造
2. 签名密钥派生
3. 签名字符串生成

其中规范化请求包含：

• HTTP方法
• URI路径
• 查询字符串
• 请求头（包括X-Amz-Copy-Source）
• 签名头

当任何参与签名的元素处理不一致时，就会导致签名验证失败。中文字符在URL中需要编码为UTF-8字节序列的百分号编码形式，这是常见的签名错误来源。

影响范围

该问题主要影响：

1. 使用华为云OBS作为存储后端的AList用户
2. 涉及中文文件名操作的场景
3. 文件重命名、移动等修改路径的操作

最佳实践建议

对于开发者集成对象存储服务时：

1. 始终对路径中的非ASCII字符进行编码
2. 了解不同云服务商对编码处理的细微差异
3. 在签名计算前确保所有参与签名字段的最终形式
4. 使用标准库进行URL编码而非自定义实现

对于AList用户：

1. 遇到类似签名错误时可检查文件名中的特殊字符
2. 更新到修复该问题的版本
3. 暂时可使用英文名称或拼音替代

总结

该案例展示了在云存储集成中字符编码处理的重要性，特别是在涉及签名验证的场景。AList开发团队通过精准定位请求头处理问题，解决了华为云OBS中文文件重命名的兼容性问题，提升了多语言环境下的用户体验。