保证请求重试的幂等性,核心在于为每次请求生成唯一的业务标识(如 requestid),并在服务端利用该标识进行去重。客户端在发起请求时生成 uuid 并放入 header,服务端在接收请求后检查 redis 中是否存在该 id,若存在则直接返回缓存结果,否则执行业务逻辑并存储结果。

如何生成和传递唯一请求ID
在客户端发起请求前,使用 crypto.randomUUID() 生成全局唯一标识符,并通过 HTTP 请求头 X-Request-ID 传递给服务端。这确保了即使网络波动导致多次重试,服务端也能通过同一个 ID 识别出这是同一次业务操作。

const requestId = crypto.randomUUID();
fetch('/api/submit', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-Request-ID': requestId // 关键:传递唯一ID
},
body: JSON.stringify({ data: 'important' })
});
服务端如何实现基于ID的去重
服务端接收到带有 X-Request-ID 的请求后,首先查询 Redis 中是否已存在该 ID 对应的结果。如果存在,说明该请求已被处理过,直接返回缓存的结果;如果不存在,则执行具体的业务逻辑,并将结果存入 Redis,设置合理的过期时间以防止内存无限增长。

// Node.js 伪代码示例
app.post('/api/submit', async (req, res) => {
const requestId = req.headers['x-request-id'];
// 1. 检查是否已处理
const cachedResult = await redis.get(requestId);
if (cachedResult) {
return res.json(JSON.parse(cachedResult));
}
try {
// 2. 执行业务逻辑
const result = await processBusinessLogic(req.body);
// 3. 存储结果到Redis,设置过期时间(如24小时)
await redis.setex(requestId, 86400, JSON.stringify(result));
res.json(result);
} catch (error) {
// 4. 异常时也记录,防止重复重试导致日志爆炸
await redis.setex(`err_${requestId}`, 3600, error.message);
res.status(500).json({ error: error.message });
}
});
如何处理并发冲突导致的非幂等情况
当多个请求同时到达且 Redis 中均无该 ID 记录时,可能会发生竞态条件。此时应使用 Redis 的原子操作 SETNX(Set if Not Exists)来确保只有一个请求能成功获取“处理权”。其他请求在等待或检测到锁释放后,再次查询结果即可实现最终一致性。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











