微信云端托管上的 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 发送一个旧时间戳的请求,就能快速定位是哪一步产生了误判。
手动模拟时,可以在本地构造一个旧时间戳的请求:
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。上线后如果观察到大量合法请求被拒,优先检查客户端时钟是否偏差过大,以及签名内容是否缺少时间戳;确认不是这些问题后,再小范围调整窗口。不要把校验直接删掉,回滚手段应该是调整中间件参数,而不是绕过签名校验。