Laravel缓存驱动配置问题：使用Varnish遇“Driver [varnish] is not supported”错误

核心原因 #

Laravel官方缓存系统没有内置Varnish驱动，直接在config/cache.php中配置driver => 'varnish'会触发该错误——框架找不到对应的驱动实现类。

解决方案 #

方案一：使用第三方Varnish缓存驱动包 #

如果一定要把Varnish作为Laravel的缓存驱动使用，需要借助第三方包实现：

1. 安装维护活跃的第三方包，例如：

   composer require fastly/laravel-varnish
   

2. 发布包的配置文件：

   php artisan vendor:publish --provider="Fastly\LaravelVarnish\VarnishServiceProvider"
   

3. 修改config/cache.php中的varnish配置，适配包的要求（不同包参数可能略有差异）：

   'varnish' => [
       'driver' => 'varnish',
       'hostname' => '127.0.0.1',
       'port' => 9000,
       'timeout' => 3,
   ],
   

4. 确认包的服务提供者已自动注册，若未注册则手动添加到config/app.php的providers数组中。

方案二：将Varnish作为反向代理缓存（推荐用法） #

Varnish的常规用法是作为HTTP反向代理缓存，而非Laravel的缓存驱动，这种方式无需修改Laravel缓存配置：

1. 修改Varnish的default.vcl，配置后端指向Laravel应用的运行端口（比如php artisan serve默认的8000端口）：

   backend default {
       .host = "127.0.0.1";
       .port = "8000";
   }
   

2. 重启Varnish服务，确保它监听9000端口并转发请求到Laravel
3. 访问应用时直接请求http://127.0.0.1:9000（Varnish端口），而非Laravel的8000端口
4. 在Laravel控制器中通过设置HTTP缓存头控制Varnish的缓存策略：

   return response($content)->header('Cache-Control', 'public, max-age=3600');
   

额外排查步骤 #

• 若使用第三方包，确认包与当前Laravel版本兼容
• 运行php artisan config:clear清除配置缓存，确保新配置生效
• 检查是否存在自定义缓存驱动注册逻辑冲突

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