ThinkPHP 6.0 分布式环境下雪花算法生成 ID【唯一性】

先说几个核心判断：ThinkPHP 6.0 本身确实不提供雪花算法的原生实现，所以 ID 的唯一性不能指望框架自动保障。它需要你正确地集成第三方库，并且在配置、部署的每个环节都踩准了，才能真正跑通。

问题不在“能不能用”，而在“怎么用才能不重复”。

那么，要保证唯一性，需要搞定哪几个前提？

• workerId 必须全局唯一：同一个数据中心里，每台服务器或者每个容器的 workerId 都不能重复。很多人图省事，硬编码成 1，结果在 Docker 或 K8s 里一跑就撞车，这是最常见的问题。
• datacenterId + workerId 组合必须固定且可区分：建议通过配置文件加上环境变量来管理，比如：

  // config/snowflake.php
  return [
      'dc' => (int)env('SNOWFLAKE_DC', 1),
      'worker' => (int)env('SNOWFLAKE_WORKER', 1),
  ];

• 时间戳必须严格单调递增：PHP 的 microtime(true) 很容易受系统时钟回拨影响，最好用 hrtime(true) 并做 floor($ts / 1e6) 处理。一旦检测到时钟回拨，必须直接抛异常中断，不能 sleep 或降级生成，否则必然引发重复。
• sequence 必须进程隔离：静态变量或类属性在 FPM 多进程下确实是各自维护的，但跨进程就无法同步了。高并发场景下，静态变量是扛不住的，必须用 Redis 做外部序列计数：

  $key = "snowflake:seq:{$workerId}";
  $seq = $redis->incr($key);
  $redis->expire($key, 30); // 防堆积

接下来，怎么在 ThinkPHP 模型里安全接入 ID 生成？

• 首先，关闭自增主键，显式接管 id 字段：

  protected $pk = 'id';
  protected $autoWriteTimestamp = false;

• 然后，在 beforeWrite 中生成 ID，确保每次 sa ve 只调用一次：

  protected function beforeWrite(): void
  {
      if (empty($this->id)) {
          $generator = new OvertrueSnowflakeIdGenerator(
              config('snowflake.dc'),
              config('snowflake.worker')
          );
          $this->id = $generator->id();
      }
  }

• 数据库字段必须是 BIGINT UNSIGNED，否则那些超大的 ID（比如 1234567890123456789）在 32 位 PHP 或 MySQL 类型不匹配时，会直接被截断或转成科学计数法，这就是隐患。

再来说说多服务器部署的坑。

• 不要复用同一个 IdGenerator 实例跨请求或跨进程。
• 命令行任务（比如队列消费者）需要单独初始化，不能共享 Web 请求中的实例。
• 容器重启后，如果用文件锁存 sequence，记得清理旧锁文件，否则可能卡死。
• 上线前检查一下 php -r "echo PHP_INT_SIZE;" —— 输出必须是 8。如果不是，整个 ID 要按字符串处理（返回 (string)$id，数据库字段改成 VARCHAR(20)，并关闭 ORM 的类型转换）。

说起来不复杂，但每一步都容易忽略。真正跑在生产环境前，这些细节最好都过一遍。