Laravel应用在WSL环境下使用phpredis的Redis延迟异常问题

核心问题 #

使用phpredis扩展连接WSL中的Redis时，首次连接后，同一秒内多次请求仍持续出现高延迟（远高于Redis Insight显示的处理时间）。

可能原因及解决方法 #

1. WSL 网络转发开销 #

若Laravel运行在Windows主机、Redis部署在WSL内，使用localhost连接会触发跨系统网络转发，产生额外开销。

• 解决方式：
  • 在WSL中执行hostname -I获取内部IP，改用该IP连接Redis，避免跨系统转发。
  • 修改WSL内的redis.conf，绑定0.0.0.0并关闭保护模式，确保外部可正常访问。

2. phpredis 未启用持久化连接 #

Laravel默认Redis连接可能未开启持久化，导致同一秒内的多次请求仍重复建立连接。

• 调整配置：打开config/database.php，在Redis默认连接项中添加持久化配置：

  'redis' => [
      'client' => env('REDIS_CLIENT', 'phpredis'),
      'default' => [
          'host' => env('REDIS_HOST', '127.0.0.1'),
          'password' => env('REDIS_PASSWORD', null),
          'port' => env('REDIS_PORT', '6379'),
          'database' => env('REDIS_DB', '0'),
          'persistent' => true, // 启用持久化连接
      ],
  ],
  

  注：需确保phpredis扩展版本≥4.0，支持持久化连接特性。

3. Redis TCP 参数优化 #

WSL中Redis默认TCP参数未针对低延迟优化，可能导致连接复用效率低下。

• 修改Redis配置：在redis.conf中添加或调整以下参数：

  tcp-keepalive 300
  tcp-backlog 511
  timeout 0
  

  修改后重启Redis服务生效。

4. 测试代码计时准确性 #

当前测试代码的计时包含了Redis命令执行+网络传输的全部时间，可能误判连接复用情况。可单独测试连接复用效果：

• 优化测试代码：

  Route::get('redis-test', function () {
      // 提前建立连接
      Redis::ping();
      
      // 多次执行同一命令，观测耗时变化
      for ($i = 0; $i < 5; $i++) {
          $start = microtime(true);
          Redis::hget("test", "key");
          $end = microtime(true);
          echo "第{$i+1}次耗时: " . ($end - $start)*1000 . "ms<br>";
      }
  });
  

  正常情况下，除首次外后续耗时应稳定在低水平。

5. WSL 资源限制 #

WSL默认的CPU、内存配额可能限制Redis性能，导致高延迟。

• 调整WSL资源配置：在Windows用户目录下创建.wslconfig文件，添加资源分配规则：

  [wsl2]
  memory=4GB
  processors=2
  

  执行wsl --shutdown重启WSL后生效。

额外排查点 #

• 升级phpredis扩展至最新稳定版，旧版本可能存在连接复用相关bug。
• 开启Redis慢查询日志（设置slowlog-log-slower-than 1000），排查是否存在慢命令导致延迟。

内容的提问来源于stack exchange，提问作者جهاد الادهمي