通过为每个接口请求生成唯一的幂等性令牌(idempotency key)并在服务端进行状态校验,可以有效解决重复提交问题。具体做法是在前端发起请求前获取一个临时令牌,随请求一并发送至后端;后端在执行业务逻辑前检查该令牌是否已存在且未处理,若存在则直接返回缓存结果或拒绝执行,从而确保同一业务操作只被处理一次。

generate_token() 如何创建唯一标识
使用 bin2hex(random_bytes(32)) 生成符合 RFC 4122 标准的 UUID v4 格式字符串作为令牌。这种随机数生成方式在 PHP 7+ 环境中具有极高的熵值,能够保证令牌的不可预测性和全局唯一性,避免客户端伪造或碰撞。

check_and_lock() 如何处理并发冲突
利用 Redis 的 SET key value NX EX seconds 原子命令实现分布式锁。当多个请求同时到达时,只有第一个成功设置键值的请求能继续执行后续逻辑,其余请求因 NX 条件不满足而立即失败,从而防止高并发下的重复执行。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
立即学习“PHP免费学习笔记(深入)”;

基于 status=locked 的具体响应处理
当检测到令牌已存在但状态为 locked 时,系统应返回 HTTP 409 Conflict 并附带当前任务进度。这允许前端根据状态码决定是轮询进度还是提示用户稍后重试,而不是盲目地重新提交表单导致数据冗余。
<?php
// IdempotencyManager.php
class IdempotencyManager {
private $redis;
public function __construct($redis) {
$this->redis = $redis;
}
// 生成唯一令牌
public function generateToken(): string {
return bin2hex(random_bytes(32));
}
// 尝试锁定令牌
public function checkAndLock(string $token, int $ttl = 60): bool {
$key = "idempotency:" . $token;
// SETNX + EX 原子操作
return $this->redis->set($key, 'processing', ['nx', 'ex' => $ttl]);
}
// 获取令牌状态
public function getStatus(string $token): ?string {
return $this->redis->get("idempotency:" . $token);
}
}
// Usage Example
$manager = new IdempotencyManager($redis);
$token = $manager->generateToken();
echo "Generated Token: " . $token . "\n";
if ($manager->checkAndLock($token)) {
echo "Lock acquired. Processing...\n";
// Business Logic Here
$manager->redis->set("idempotency:" . $token, 'completed');
} else {
echo "Duplicate request detected or lock failed.\n";
}
?>
预期输出:首行打印生成的 64 位十六进制字符串,第二行显示 “Lock acquired. Processing...” 或 “Duplicate request detected...”。


















