接手过一个中转站请求转发模块,最早是在下游返回 RequestTimeTooSkewed 时开始查签名。这类错误通常不是网络问题,而是签名的有效时间窗被跨过了。下面记录一下我当时的确认顺序和改法。
先确认现象:是签名过期还是时钟偏移
遇到重试后仍返回签名类错误,我会先把请求头和当前服务器时间都拉出来对比。需要确认的是,到底属于签名过期,还是节点时钟偏了。
SigV4签名中的X-Amz-Date和Date头共同定义了请求的有效时间窗口,默认从签名时间起15分钟内有效。中转站在收到上游失败响应并准备重试时,若距离首次签名已接近或超过这个窗口,直接复用原始签名会导致下游返回SignatureDoesNotMatch或RequestTimeTooSkewed。判断条件是:用当前时间减去签名头中的时间戳,若超过300秒,必须重新签名;同时还要检查服务器时钟偏差,超过15分钟即使重签名也会失败。所以我会先执行 date 和 date -u 看本机时间,再对照请求里 X-Amz-Date 的差值。如果差值很小,那就是时钟偏了;如果差值接近300秒,那就是窗口问题。两种情况的处理方向不一样,前者要校准节点时钟,后者才需要重签名。
容易误判的地方:只更新日期头是不够的
第一轮改完重试,签名错误少了,但偶尔还有 SignatureDoesNotMatch。后来发现是改签名的位置没改全。
这里要特别留意:CredentialScope 里的 date 字段是“签名日期”,不是完整的日期时间。有些签名库内部会缓存 date,需要强制刷新。另外,如果用了旧 access key,即使重新签名也会失败。我当时的做法是把签名逻辑收敛到一个独立函数里,所有重试都走同一个入口,避免散落多处。
建议的处理顺序:重试前无条件重签名
与其每次判断剩余时间,不如在触发重试时直接走重签名。这个策略更简单,也更容易覆盖边界情况。
最简单的规避策略是:无论首次签名后经过多长时间,只要触发重试就无条件重新签名。实现时注意从原始请求中剥离旧的Authorization、X-Amz-Date和X-Amz-Security-Token头,再基于目标服务的endpoint、区域和当前UTC时间生成新签名。该方法避免了判断时间窗口的复杂逻辑,但会增加少量计算开销,且若使用临时凭证,需确保会话令牌在重试前未过期,否则应重新获取凭证。这个方案避免了判断“是否超过300秒”的边界,但要注意两个前提:一是重试次数有限,避免反复签名消耗;二是临时凭证的过期时间要单独检查。如果凭证只剩几十秒,重签名后可能马上又失效。对于STS凭证,我通常会在重签名前先看 Expiration 字段,剩余时间少于5分钟就申请新凭证。
另外,重签名只能让请求通过签名验证,不能消除非幂等请求重复执行的风险。所以在重签名时,我会刻意保持请求体里的唯一业务ID不变,让下游有去重依据。
代码示例:如何安全地重新签名
下面这段Python略去了标准签名算法细节,重点展示需要传哪些参数、哪些头必须先剥离。执行位置放在重试逻辑的入口,确保每次重试都拿到新签名。
import datetime
import hashlib
def resign_request(method, url, headers, body, access_key, secret_key, session_token):
# 先去掉旧签名相关头,避免干扰新签名
headers.pop('Authorization', None)
headers.pop('X-Amz-Date', None)
headers.pop('X-Amz-Security-Token', None)
headers.pop('X-Amz-Content-Sha256', None)
now = datetime.datetime.utcnow()
amz_date = now.strftime('%Y%m%dT%H%M%SZ')
date_stamp = now.strftime('%Y%m%d')
# 重新计算body哈希(如果body未变,哈希不变;若body里加了重试标记,必须重算)
payload_hash = hashlib.sha256(body if body else b'').hexdigest()
headers['X-Amz-Date'] = amz_date
headers['X-Amz-Content-Sha256'] = payload_hash
if session_token:
headers['X-Amz-Security-Token'] = session_token
# 这里应该调用botocore或自研签名函数,传入完整URL、method、headers、payload_hash
# 注意Authorization中的CredentialScope date必须使用date_stamp
# signature = compute_sigv4(method, url, headers, payload_hash, access_key, secret_key, date_stamp)
# headers['Authorization'] = signature
return headers这段代码的验证方式是:在重试前打印一份 headers 和 X-Amz-Date,然后观察下游是否还报签名错误。失败时优先检查 CredentialScope 里的日期是否与 X-Amz-Date 的日期部分一致,以及 session_token 是否已经过期。
另外,检查节点时钟偏差可以用下面的命令。执行位置在中转站每个节点上,观察偏移是否在可接受范围。
ntpq -p
# 如果没有NTP服务,先看系统时间
date -u这条命令不会打印签名结果,但它能帮你判断问题根源。如果偏移超过几百毫秒,就需要先校准时钟,否则重签名也可能继续失败。
验证与回滚:确认无误再放开重试
改完重签名逻辑后,我建议先在单条测试请求上手动触发重试,确认下游返回 200 或预期的业务错误,而不是签名错误。重点关注两个点:一是重试后的 Authorization 头时间戳是否更新;二是若请求体包含唯一请求ID,重签名时不要改变该ID,这样下游去重逻辑仍然有效。
如果发现重签名后出现了新的问题(比如某些服务不认新签名),第一件事是回滚到旧的“只判断时间戳”逻辑。回滚边界要清楚:无条件重签名只影响重试路径,不影响首次发送。所以回滚时只回滚重试分支,不需要改动主流程。
后续维护
后续维护方面,建议定期检查各节点 ntp 服务状态,并给临时凭证加一个提前刷新机制。如果重试次数较多,还可以在日志里记录“重签名发生次数”和“签名时间差”,方便观察是否存在反复重试。