如何在 Laravel 中高效生成唯一 Slug（支持自动递增后缀）_技术教程

本文介绍一种高效、递归可控的方式，在 laravel 中为博客分类等资源生成唯一 slug，避免重复检测导致的性能问题，支持如 `test` → `test-1` → `test-2` 的智能递增逻辑。

在 Laravel 应用中，为文章分类、标签或页面生成 URL 友好的 Slug 是常见需求。使用 Str::slug($request->title) 虽然简单，但无法保证唯一性——当多个分类同名（如都叫“技术”）时，会生成重复的 ji-shu，导致路由冲突或数据库唯一约束失败。

直接循环拼接数字（如 test, test1, test2…）并逐个查询数据库，时间复杂度随冲突次数线性上升，尤其在高并发或大数据量场景下极易成为性能瓶颈。更优解是：一次解析 + 一次查询 + 智能递增，而非暴力轮询。

以下是推荐的优化实现方案，建议封装在控制器或专用 SlugService 类中：

✅ 步骤一：提取 Slug 末尾数字

该函数精准识别已有 Slug 的数字后缀长度（如 news-5 返回 1，demo-102 返回 3），为后续递增提供依据：

protected function countEndingDigits(string $string): int
{
    $length = strlen($string);
    $count = 0;
    $i = 1;

    while ($i <= $length) {
        $char = $string[$length - $i];
        if (is_numeric($char)) {
            $count++;
            $i++;
        } else {
            break;
        }
    }

    return $count;
}

? 注意：原答案中存在变量名错误（如 $numInUN 未定义）、逻辑缺陷（未处理 - 分隔符）及潜在无限递归风险。本实现已修复并增强鲁棒性。

✅ 步骤二：递归生成唯一 Slug

核心逻辑：若 Slug 已存在，则解析其数字后缀，+1 后重新校验；若无数字后缀，则追加 -1：

protected function ensureUniqueSlug(string $baseSlug, string $table = 'blog_tags', string $column = 'slug'): string
{
    // 先尝试原始 slug
    if (DB::table($table)->where($column, $baseSlug)->exists()) {
        $digitCount = $this->countEndingDigits($baseSlug);

        if ($digitCount > 0) {
            // 提取基础名（不含末尾数字）和当前数字
            $numericPart = (int) substr($baseSlug, -$digitCount);
            $basePart = substr($baseSlug, 0, -$digitCount);

            // 移除可能残留的连字符（如 test-5 → test）
            $basePart = rtrim($basePart, '-');

            $nextSlug = $basePart . '-' . ($numericPart + 1);
        } else {
            // 首次冲突：添加 "-1"
            $nextSlug = $baseSlug . '-1';
        }

        // 递归确保新 slug 也唯一（深度可控，通常 ≤ 3 层）
        return $this->ensureUniqueSlug($nextSlug, $table, $column);
    }

    return $baseSlug;
}

✅ 使用示例

在控制器 store 或 update 方法中调用：

use Illuminate\Support\Str;

public function store(Request $request)
{
    $title = $request->input('title');
    $slug = Str::slug($title);
    $uniqueSlug = $this->ensureUniqueSlug($slug);

    BlogTag::create([
        'title' => $title,
        'slug'  => $uniqueSlug,
    ]);

    return redirect()->back()->with('success', '分类创建成功！');
}