ThinkPHP 6.0 需集成第三方 Snowflake 库保障 ID 唯一性，核心是确保 workerId 全局唯一、datacenterId+workerId 组合固定、时间戳单调递增（用 hrtime 并防回拨）、sequence 进程隔离（推荐 Redis），模型中关闭自增主键并在 beforeWrite 中生成 ID，数据库字段须为 BIGINT UNSIGNED，多服务器部署需避免实例复用、命令行任务单独初始化、容器重启清理锁文件，并确认 PHP_INT_SIZE 为 8。

ThinkPHP 6.0 本身不提供雪花算法实现，唯一性不是靠框架自动保障的，而是靠你正确集成、配置和使用第三方 Snowflake 库来达成。

关键不在“能不能用”，而在“怎么用才不重复”。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

保证唯一性的核心前提

• workerId 必须全局唯一：同一数据中心内，每台服务器（或每个容器）的 workerId 不能重复。常见错误是硬编码为 1 或从 IP 算出后在 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（确保每次 save 只调一次）：

  protected function beforeWrite(): void
  {
      if (empty($this->id)) {
          $generator = new \Overtrue\Snowflake\IdGenerator(
              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 类型转换）。

不复杂但容易忽略。