Laravel ObjectId 性能最强体积最小的分布式 UUID 生成扩展

news/2025/11/12 8:05:23/文章来源:https://www.cnblogs.com/catchadmin/p/19212147

Laravel ObjectId 性能最强体积最小的分布式 UUID 生成扩展

相信每位 Laravel 开发者都遇到过这种情况：新建项目、写迁移、模型默认用自增 ID。开始挺好，但等到系统要上分布式、对接 API、搞微服务的时候，整数 ID 的局限性就暴露出来了。

Laravel ObjectId 就是为了解决这个问题：一套开箱即用的全局唯一 ID 方案，借鉴了 MongoDB ObjectId 的设计思路，可以直接用在 MySQL、MariaDB 和 PostgreSQL 上，不需要装 MongoDB。

原文链接 Laravel ObjectId 性能最强体积最小的分布式 UUID 生成扩展

为什么要用 ObjectId？

和 UUID、ULID 比起来，ObjectId 只有 12 字节，里面包含了时间戳、随机值和计数器，所以天然可排序、体积小、跨系统唯一。

性能数据很直观：生成速度是 UUID 的 3 倍，占用空间更小，直接拉升数据库性能和索引效率。

原生支持 MySQL、MariaDB 和 PostgreSQL
不依赖 MongoDB 驱动或扩展

ObjectId 内部结构

ObjectId 是个 12 字节（96 位）的标识符，分成四个部分：

组成部分	占用空间	说明
时间戳	4 字节	UNIX 时间戳秒数，保证 ID 按时间排序
机器标识	5 字节	随机生成，每台机器不同
进程 ID	2 字节	标识当前进程
自增计数器	3 字节	每个进程独立计数，初始值随机

总共：4 + 5 + 2 + 3 = 12 字节 = 24 位十六进制字符

这个设计的好处是不需要中心化的 ID 生成服务就能保证唯一性，还能按时间顺序排列，特别适合分布式系统。

扩展阅读：

MongoDB ObjectId 官方文档
Percona 关于 ObjectId 的深度解析
Stack Overflow 上的 ObjectId 结构分析

安装

composer require wooserv/laravel-objectid

使用方式

在模型中使用

use WooServ\LaravelObjectId\Concerns\HasObjectIds;
use Illuminate\Database\Eloquent\Model;class Post extends Model
{use HasObjectIds;
}

迁移文件写法

Schema::create('posts', function (Blueprint $table) {$table->objectId(); // Creates a 24-char string primary key$table->string('title');$table->timestamps();
});

手动生成 ID

$id = objectid(); // e.g. 6730b6a0d8a28f890b7c9f40

性能测试

ID 生成速度（10,000 次）

----------------------------------------------------------
ObjectId             : 0.412 µs per ID
objectid() helper    : 0.417 µs per ID
UUID                 : 1.283 µs per ID
ULID                 : 1.147 µs per ID
----------------------------------------------------------
结论：ObjectId 最快

数据库插入速度（1,000 条）

----------------------------------------------------------
ObjectId   : 14.78 ms total (0.015 ms/insert)
UUID       : 15.48 ms total (0.015 ms/insert)
ULID       : 15.17 ms total (0.015 ms/insert)
----------------------------------------------------------

三者对比

对比项	ObjectId	UUID	ULID
字符串长度	24 字符	36 字符	26 字符
字节数	12	16	16
时间排序	支持	不支持	支持
随机性	支持	支持	支持
可读性	简洁	冗长	适中
生成速度	最快	最慢	中等
MySQL/MariaDB/PostgreSQL 支持	支持	支持	支持
是否需要 MongoDB	不需要	不需要	不需要