如何在Laravel项目中为ID生成器实现PostgreSQL的nextval()函数？

实现步骤 #

1. 创建PostgreSQL序列 #

首先在PostgreSQL数据库中创建自定义序列，用于生成ID的后缀部分：

CREATE SEQUENCE student_id_seq
    START WITH 1
    INCREMENT BY 1
    MINVALUE 1
    MAXVALUE 99999
    CYCLE; -- 可选：当后缀达到99999后循环回1，无需则删除该参数

如果数据库已有历史数据，需将序列起始值同步为现有最大后缀值+1，比如现有最大后缀是12345，执行：

ALTER SEQUENCE student_id_seq RESTART WITH 12346;

2. 修改Laravel的ID生成逻辑 #

替换原有路由闭包逻辑，通过nextval()获取序列值，拼接前缀后校验唯一性：

Route::get('/check-student-id', function() {
    $prefix = "20";
    $existingIds = array_merge(
        StudentModel::pluck('Student ID')->toArray(),
        PersonModel::pluck('id')->toArray()
    );

    do {
        // 调用PostgreSQL序列获取自增值
        $seqValue = DB::select("SELECT nextval('student_id_seq') AS val")[0]->val;
        // 格式化为5位补零后缀
        $suffix = str_pad($seqValue, 5, '0', STR_PAD_LEFT);
        $newId = $prefix . $suffix;
    } while (in_array($newId, $existingIds));

    return $newId;
});

3. 优化并发安全性 #

高并发场景下，可通过事务+排他锁避免ID冲突：

Route::get('/check-student-id', function() {
    $prefix = "20";
    
    return DB::transaction(function () use ($prefix) {
        // 锁定关联表，防止并发生成重复ID
        DB::statement('LOCK TABLE students, persons IN EXCLUSIVE MODE');
        
        $existingIds = array_merge(
            StudentModel::pluck('Student ID')->toArray(),
            PersonModel::pluck('id')->toArray()
        );

        do {
            $seqValue = DB::select("SELECT nextval('student_id_seq') AS val")[0]->val;
            $suffix = str_pad($seqValue, 5, '0', STR_PAD_LEFT);
            $newId = $prefix . $suffix;
        } while (in_array($newId, $existingIds));

        return $newId;
    });
});

关键说明 #

• nextval()是PostgreSQL原生原子操作，相比原逻辑的max()取值，能从根源降低并发重复ID的概率。
• 若业务不允许ID循环，删除序列创建语句中的CYCLE参数，当后缀达到99999时nextval()会抛出报错，需手动扩容序列范围或处理逻辑。
• 首次创建序列必须同步现有数据的最大后缀值，否则会生成重复ID。

内容的提问来源于stack exchange，提问作者CaptainCRAZY