Laravel版本灰度发布实现方案及升级测试方法咨询

一、按比例分流用户完全可行，两种主流实现方案 #

1. 服务器层面（Nginx）分流 #

借助Nginx的split_clients模块在入口层直接做流量分配，无需改动业务代码，适合快速落地：

split_clients "${remote_addr}" $variant {
    20%    "laravel9";
    *      "laravel55";
}

server {
    listen 80;
    server_name yourdomain.com;

    location / {
        if ($variant = "laravel9") {
            proxy_pass http://laravel9_backend;
        }
        if ($variant = "laravel55") {
            proxy_pass http://laravel55_backend;
        }
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

该方案基于用户IP哈希计算，同一个用户会稳定访问同一版本，避免频繁切换带来的体验割裂。

2. Laravel中间件分流 #

如果需要结合用户属性、Cookie等做更灵活的控制，可以编写Laravel中间件实现：

<?php

namespace App\Http\Middleware;

use Closure;
use Illuminate\Http\Request;

class RouteToCorrectVersion
{
    public function handle(Request $request, Closure $next)
    {
        // 优先读取Cookie，保证用户访问一致性
        $versionCookie = $request->cookie('laravel_version');
        if ($versionCookie) {
            return $this->routeToVersion($versionCookie);
        }

        // 按20%比例分配到Laravel9
        $random = mt_rand(1, 100);
        $targetVersion = $random <= 20 ? 'laravel9' : 'laravel55';
        
        // 设置Cookie，有效期7天
        return $this->routeToVersion($targetVersion)->withCookie(cookie('laravel_version', $targetVersion, 60*24*7));
    }

    protected function routeToVersion(string $version)
    {
        if ($version === 'laravel9') {
            return redirect()->away('https://laravel9.yourdomain.com');
            // 也可根据架构直接转发请求到对应后端
        }
        return redirect()->away('https://laravel55.yourdomain.com');
    }
}

注册中间件后，可全局或在指定路由组中启用。

二、更优的新版本测试方法 #

• 分层灰度发布：不要直接切20%流量，按内部员工→种子用户→小比例普通用户的顺序逐步扩大范围，降低风险扩散
• 功能开关（Feature Flag）：在Laravel9版本中给核心功能添加开关，遇到问题时可快速关闭特定功能，无需回滚整个版本
• 自动化测试补全：针对Laravel9版本完善单元测试、集成测试、端到端测试，提前排查版本兼容问题，比如用PHPUnit/Pest做单元测试，Cypress做端到端测试
• 定向用户测试：选择特定用户群体（如付费用户、高活跃用户）做定向测试，收集更精准的反馈
• 实时监控告警：为Laravel9版本配置错误日志、性能指标、数据库查询等监控，一旦出现异常（如错误率骤升），自动切换回旧版本
• 会话复制验证：复制线上真实用户的请求到Laravel9版本，在不影响正常用户的前提下验证功能正确性

内容的提问来源于stack exchange，提问作者Lorenzo Lorini Kalil