Ruby on Rails中Google Storage签名URL出现SignatureDoesNotMatch问题

我之前也碰到过一模一样的问题，结合google-cloud-storage gem的用法和GCS的签名规则，给你几个实用的排查和解决方向：

1. 确保请求方法参数完全匹配 #

生成签名URL时必须显式指定method参数，而且必须是大写的HTTP方法名（GCS对大小写敏感），比如生成PUT签名URL的代码要这样写：

bucket.signed_url "your-object-path", method: "PUT", expires: 3600

如果写成小写的put，或者实际请求用了DELETE但签名时指定的是PUT，都会直接触发签名不匹配错误。

2. 同步自定义请求头参数 #

如果实际请求中会携带自定义头（比如上传文件时的Content-Type），生成签名URL时必须把这些头也同步声明进去。比如要上传一张JPG图片，生成签名URL的代码需要加上content_type参数：

bucket.signed_url "images/photo.jpg", method: "PUT", expires: 3600, content_type: "image/jpeg"

实际发起PUT请求时，也必须带上完全一致的Content-Type头，不能省略或修改值。

3. 验证权限与有效期 #

• 检查生成签名所用的服务账号权限：PUT操作需要storage.objects.create或storage.objects.update权限，DELETE操作需要storage.objects.delete权限，权限不足也可能伪装成签名不匹配错误。
• 确认expires参数设置的有效期，避免使用已经过期的签名URL。

4. 核对对象路径的精确性 #

GCS的对象路径是大小写敏感的，生成签名URL时的对象路径（比如docs/report.pdf）必须和实际操作的对象路径完全一致，包括文件夹前缀、文件名的大小写，哪怕一个字母大小写不对都会导致签名验证失败。

5. 升级gem到最新版本 #

如果你的google-cloud-storage gem版本较旧，可能存在签名参数处理的bug。建议升级到最新版本：

gem update google-cloud-storage

调试小技巧 #

可以把生成签名URL时的所有参数（方法、路径、头、有效期）和实际请求的参数逐一对比，GCS的签名是基于这些参数生成的，任何细微的不一致都会触发SignatureDoesNotMatch错误。

内容的提问来源于stack exchange，提问作者Claudiu Lazăr