Laravel如何实现单路由绑定用户唯一ID后全站URL自动携带该参数

你最初设想的「首次带参访问时将用户ID存入Session」的方案完全可行，在单用户会话访问的场景下实现成本极低，但并非所有场景下的最优解——如果需要支持链接跨设备分享、清除缓存后仍能识别用户，纯Session方案会存在失效问题。下面是Laravel生态下的具体实现方式，包含官方推荐的标准写法：

一、适配你现有思路的标准实现（Session+全局中间件） #

这个实现完全贴合你最初的设计，也是Laravel处理全局会话参数的官方推荐写法，不需要修改现有业务逻辑，只需要新增一层全局处理逻辑即可。

• 调整路由定义兼容参数传递
  你可以保留原有路由路径，支持通过query参数传递用户ID，也可以改成路径参数形式，以你现有代码为例，保留/uid路径的写法不需要改动路由结构，直接支持/uid?uid=xxx形式的带参访问即可。如果要做路径参数形式，可以调整为：

  // 可选参数兼容：带uid访问时绑定，不带uid时从session读取
  Route::get('/uid/{uid?}', [HomeController::class, 'home'])->name('home');
  

• 新增全局中间件处理参数绑定
  不要在单个控制器里写参数存取逻辑，通过全局中间件统一处理是最规范的方式：
  • 执行artisan命令生成中间件文件：php artisan make:middleware BindPortfolioUserId
  • 在中间件的handle方法中写入绑定逻辑：

    <?php
    
    namespace App\Http\Middleware;
    
    use Closure;
    use Illuminate\Http\Request;
    use Illuminate\Support\Facades\URL;
    
    class BindPortfolioUserId
    {
        public function handle(Request $request, Closure $next)
        {
            // 请求中携带了合法uid时，存入会话
            if ($request->filled('uid')) {
                // 这里可以自行加校验逻辑：比如查库确认对应用户存在，避免非法参数存入
                session(['portfolio_bind_uid' => $request->input('uid')]);
            }
    
            // 会话中已存在绑定uid时，全局注入到请求实例，业务代码直接通过$request->uid读取即可
            if (session()->has('portfolio_bind_uid') && !$request->filled('uid')) {
                $request->merge(['uid' => session('portfolio_bind_uid')]);
            }
    
            // 给所有路由生成器默认绑定uid参数，后续调用route()生成链接、渲染表单时自动携带参数，不需要手动拼接
            if (session()->has('portfolio_bind_uid')) {
                URL::defaults(['uid' => session('portfolio_bind_uid')]);
            }
    
            return $next($request);
        }
    }
    

  • 将中间件注册到app/Http/Kernel.php的web中间件组中，确保所有web路由都能经过该处理逻辑。
• 业务调用方式
  配置完成后，你在任意控制器、视图、服务层代码中，都可以直接通过request('uid')获取当前绑定的用户ID；所有通过route()辅助函数生成的站内链接、表单提交地址，都会自动带上当前绑定的uid参数，不需要手动传参。

该方案的局限：用户ID存在浏览器本地会话中，用户清除缓存、换浏览器访问时，必须重新访问带uid的入口链接才能完成绑定；如果将不带参数的链接分享给其他人，对方无法识别到绑定的用户ID。

二、生产环境更推荐的独立副本方案（子域名绑定） #

如果你要做可公开分享、可被搜索引擎收录的用户专属作品集页面，比URL带参数更规范的实现是采用子域名路由，Laravel原生支持子域名参数绑定，不需要依赖Session：

// 子域名路由组，将子域名段作为用户标识参数
Route::domain('{uid}.your-portfolio-domain.com')->group(function () {
    // 把你全站所有路由都放到这个组里
    Route::get('/', [HomeController::class, 'home'])->name('home');
    // 其他作品详情、关于页等路由全部放在这里
});

这种方案下，用户访问自己的专属子域名（比如zhangsan.your-portfolio-domain.com）时，所有路由天然携带uid参数，不需要存Session、不需要额外处理参数传递，链接分享给任何人、跨设备访问都能准确识别对应用户，是目前独立用户主页、SaaS类应用的标准实现方式。

方案选型建议 #

• 轻量内部使用、不需要公开分享链接的场景，直接用第一种Session+中间件的方案即可，和你最初的思路完全一致，代码量小、性能无额外开销，是Laravel官方文档明确支持的用法。
• 需要公开分享、做SEO收录、长期运营的场景，优先选择子域名绑定方案，稳定性和规范性更好。

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