微信云端托管AI中转服务重试时校验签名时间戳避免超时重放

文章导读
微信云端托管上的 AI 中转服务,很多人会把注意力放在模型接入和鉴权上,重试反而容易被忽略。上游模型服务偶发超时常见,但如果重试时把第一次请求的签名原样带过去,服务端一旦校验签名时间戳,重试就会变成无效请求。遇到这类超时后重试一直失败,不用急着改上游超时时间,先看签名和时间戳是不是每次都一样。
📋 目录
  1. 一 每次重试前刷新签名,而不是复用第一次的签名
  2. 二 时间戳窗口和 nonce 去重要配合
  3. 三 排查时先看日志里的时间差
  4. 四 时间窗口边界设置与中间件落地
A A

微信云端托管上的 AI 中转服务,很多人会把注意力放在模型接入和鉴权上,重试反而容易被忽略。上游模型服务偶发超时常见,但如果重试时把第一次请求的签名原样带过去,服务端一旦校验签名时间戳,重试就会变成无效请求。遇到这类超时后重试一直失败,不用急着改上游超时时间,先看签名和时间戳是不是每次都一样。

在微信云端托管上部署 AI 中转服务时,如果上游调用超时,服务会发起重试。一个容易被忽略的问题是,重试请求往往直接复用第一次请求的签名和时间戳,而校验逻辑只判断时间戳是否落在有效窗口内。当上游响应超过窗口才重试时,这个请求会被判定为过期而拒绝,导致重试永远无法成功。因此,在设计重试机制时,必须明确区分首次请求和重试请求,要么让重试时刷新签名,要么在服务端对重试做特殊处理。

这里我通常选择“重试时刷新签名”,因为这个改动只在发送端,服务端校验逻辑可以保持统一,不需要为重试请求再开一条例外通道。

每次重试前刷新签名,而不是复用第一次的签名

推荐的做法是,在每次重试前重新生成签名,并更新请求头中的时间戳。这样既能让当前请求的时间戳贴近服务器时间,也便于服务端使用同一套校验逻辑处理。注意,重算签名时,原始请求体不能变,签名内容必须包含新的时间戳,否则一旦被篡改就会校验失败。在微信云托管的云函数中,可以把发送逻辑封装成一个公共函数,将时间戳作为参数传入,每次重试时重新计算,而不是缓存第一次的签名。

在云函数里实现时,发送层可以写成这样:

微信云端托管AI中转服务重试时校验签名时间戳避免超时重放
const crypto = require('crypto');

function buildSignedRequest(originalBody, timestamp, secret) {
  const text = timestamp + ':' + originalBody;
  const signature = crypto.createHmac('sha256', secret).update(text).digest('hex');
  return {
    body: originalBody,
    headers: {
      'x-timestamp': timestamp,
      'x-signature': signature,
      'x-nonce': crypto.randomUUID()
    }
  };
}

async function sendWithRetry(originalBody, secret, maxRetry = 3) {
  for (let attempt = 0; attempt <= maxRetry; attempt++) {
    const ts = Math.floor(Date.now() / 1000);
    const req = buildSignedRequest(originalBody, ts, secret);
    try {
      return await callUpstream(req);
    } catch (err) {
      if (attempt === maxRetry) throw err;
      await sleep(500 * (attempt + 1));
    }
  }
}

这段代码里,originalBody 始终保持不变,只有 timestamp 和 nonce 每次重建。验证时可以先看服务端日志中的 x-timestamp 是否随重试递增;如果每次重试的签名值完全相同,说明签名逻辑还是缓存了第一次的结果。

时间戳窗口和 nonce 去重要配合

刷新签名解决了重试被拒,但也不能把时间戳窗口无限放大,否则重放请求同样能进来。防止重放攻击需要给时间戳校验设一个有限窗口,但窗口过小会误伤网络延迟和正常重试。一个务实的思路是:在窗口内用时间戳做粗粒度校验,再用一次性随机数(nonce)做细粒度去重。这样即使重试请求携带了过去的时间戳,服务端也能根据 nonce 判断是合法重试还是恶意重放。实现 nonce 去重时,可以借助微信云托管提供的 Redis 实例,将 nonce 的过期时间设置成与时间窗口一致,窗口过后自动失效。

服务端入口中间件可以这样校验:

async function verifyRequest(req) {
  const ts = Number(req.headers['x-timestamp']);
  const nonce = req.headers['x-nonce'];
  const now = Math.floor(Date.now() / 1000);

  if (!ts || !nonce) return { ok: false, reason: 'missing header' };
  if (Math.abs(now - ts) > 30) return { ok: false, reason: 'timestamp expired' };

  const redis = getRedisClient();
  const key = 'nonce:' + nonce;
  const setResult = await redis.set(key, '1', 'PX', 60000, 'NX');
  if (setResult !== 'OK') return { ok: false, reason: 'nonce reused' };

  return { ok: true };
}

这段逻辑要放在所有业务接口之前。验证方式很简单:用同一个 nonce 连续发两次请求,第二次应当被拒绝;换一个新 nonce 后正常通过。需要结合环境看清楚 Redis 实例是否所有实例共享,多个云托管服务实例下不要用内存 Map 代替。

排查时先看日志里的时间差

排查重试超时问题时,先看服务端日志里记录的请求时间戳和当前时间差。如果差值明显大于窗口却被放行,说明校验逻辑可能没有真正检查时间戳;如果重试请求被拒,则要观察是否在入口中间件就被拦截了。建议把日志级别调到 DEBUG,打印出每次请求的签名值、时间戳和校验结果,然后构造一次延迟模拟,例如用 curl 发送一个旧时间戳的请求,就能快速定位是哪一步产生了误判。

微信云端托管AI中转服务重试时校验签名时间戳避免超时重放

手动模拟时,可以在本地构造一个旧时间戳的请求:

curl -i -X POST https://your-service.example.com/ai/chat -H 'x-timestamp: 1700000000' -H 'x-signature: 旧时间戳对应的签名' -H 'x-nonce: fixed-nonce-001' -H 'Content-Type: application/json' -d '{"prompt":"test"}'

注意签名值也需要用旧时间戳计算,不能直接复制当前请求的签名,否则失败会先发生在签名校验而不是时间戳校验。观察返回结果:如果显示时间戳过期,说明入口拦截和时间窗口都生效了;如果请求被放行,则要检查校验代码是否真正比较了 x-timestamp 与服务器时间。

时间窗口边界设置与中间件落地

时间戳校验依赖服务器时钟,微信云托管环境已经做了时钟同步,但客户端可能分布在不同时区。为减少误差,建议统一使用 Unix 时间戳(秒),并在校验时允许一个几十秒的时钟偏移,例如前后各 30 秒。不要为了支持重试而无限放宽窗口,否则重放风险会显著上升。一个可接受的平衡是:常规请求窗口为几分钟,重试请求允许额外多出若干秒,同时强制校验 nonce。把这段逻辑封装成独立中间件,在所有业务接口入口统一加载,既方便调整参数,也避免重复实现。

中间件里可以把窗口和 nonce 过期时间做成配置项,例如环境变量 SIGN_WINDOW_SECONDS=30,NONCE_TTL_MS=60000。上线后如果观察到大量合法请求被拒,优先检查客户端时钟是否偏差过大,以及签名内容是否缺少时间戳;确认不是这些问题后,再小范围调整窗口。不要把校验直接删掉,回滚手段应该是调整中间件参数,而不是绕过签名校验。