本文详解如何使用 MySQL BEFORE INSERT 触发器，结合 LPAD 与子查询，自动为字段生成形如 VDR-0001 的格式化唯一编码，并兼容 Laravel 迁移场景。
本文详解如何使用 mysql `before insert` 触发器，结合 `lpad` 与子查询，自动为字段生成形如 `vdr-0001` 的格式化唯一编码，并兼容 laravel 迁移场景。
在实际开发中，业务常需为记录生成语义化、可读性强的唯一编码（如 VDR-0001），而非仅依赖数据库自增 ID。虽然 PHP 层（如 Laravel）可手动拼接实现，但存在并发写入时竞态风险（如两个请求同时查到相同 MAX(id)，导致重复编码），且违背“数据完整性应由数据库层保障”的设计原则。真正的解决方案是将编码逻辑下沉至 MySQL，利用触发器（Trigger）在插入前自动计算并填充 code 字段。
✅ 推荐方案：MySQL BEFORE INSERT 触发器
以下是一个健壮、可直接部署的触发器定义（适用于 MySQL 5.7+ 或 MariaDB）：
DELIMITER $$
CREATE TRIGGER vendor_generate_code
BEFORE INSERT ON vendors
FOR EACH ROW
BEGIN
DECLARE next_id INT DEFAULT 1;
SELECT COALESCE(MAX(id), 0) + 1 INTO next_id FROM vendors;
SET NEW.code = CONCAT('VDR-', LPAD(next_id, 4, '0'));
END$$
DELIMITER ;? 说明：
- COALESCE(MAX(id), 0) 确保表为空时从 1 开始；
- LPAD(next_id, 4, '0') 将数字左补零至 4 位（如 7 → '0007'）；
- CONCAT('VDR-', ...) 拼接前缀；
- NEW.code 直接赋值，该值将在 INSERT 执行时生效，无需 PHP 干预。
?️ Laravel 迁移集成（推荐方式）
你可在 Laravel 迁移文件中安全地创建该触发器（注意：需确保数据库用户有 TRIGGER 权限）：
<?php
use Illuminate\Database\Migrations\Migration;
use Illuminate\Support\Facades\DB;
return new class extends Migration
{
public function up(MigrationBuilder $migration): void
{
DB::unprepared("
DELIMITER $$
CREATE TRIGGER vendor_generate_code
BEFORE INSERT ON vendors
FOR EACH ROW
BEGIN
DECLARE next_id INT DEFAULT 1;
SELECT COALESCE(MAX(id), 0) + 1 INTO next_id FROM vendors;
SET NEW.code = CONCAT('VDR-', LPAD(next_id, 4, '0'));
END$$
DELIMITER ;
");
}
public function down(MigrationBuilder $migration): void
{
DB::unprepared('DROP TRIGGER IF EXISTS vendor_generate_code');
}
};运行 php artisan migrate 即可启用。此后，无论通过 Eloquent Vendor::create([...]) 还是原生 SQL 插入，只要 code 字段未显式指定（或设为 NULL），触发器均会自动填充。
⚠️ 关键注意事项
- 并发安全性：此方案依赖 SELECT MAX(id)，在高并发下 仍存在极小概率冲突（因非原子操作）。若系统要求强一致性，建议改用 AUTO_INCREMENT + 计算列（MySQL 8.0.13+ 支持 GENERATED ALWAYS AS），或引入数据库序列（PostgreSQL）/ 乐观锁机制。
- 性能考量：每次插入均执行一次 MAX(id) 查询，对超大表（千万级）可能有轻微开销；可通过添加 id 索引优化（通常主键已索引，无需额外操作）。
- Laravel 模型适配：需在 Vendor 模型中将 code 声明为 $fillable（若需批量赋值），或更推荐将其设为 guarded = [] 并移除 code 字段的显式赋值逻辑——让数据库全权负责。
- 初始数据兼容性：若表已有数据，建议先为历史记录补全 code（如 UPDATE vendors SET code = CONCAT('VDR-', LPAD(id, 4, '0'))），再创建触发器，避免新旧逻辑混用。
✅ 总结
将 VDR-XXXX 编码逻辑交由 MySQL 触发器处理，是兼顾简洁性、可靠性与维护性的最佳实践。它消除了应用层竞态风险，统一了数据生成规则，并与 Laravel 生态无缝衔接。只需一行触发器定义，即可让 code 字段像 id 一样“自动生长”——真正实现服务端自动化与数据自治。
