Laravel中RdKafka库异常：CLI可用Web应用报类未找到错误

首先，咱们得戳破这个常见的坑：你在php artisan tinker里能正常用RdKafka，但Web应用不行，大概率是CLI模式和Web服务器用的是两套完全不同的PHP配置文件。我之前踩过好几次这个坑，下面给你一步步排查和解决：

1. 先验证CLI与Web环境的PHP配置差异 #

先确认两个环境是否真的加载了同一个RdKafka扩展：

• 在你的Laravel路由里临时加一段代码，输出Web环境的PHP信息：

  Route::get('/phpinfo', function () {
      phpinfo();
  });
  

  访问这个路由，搜索RdKafka，看是否有这个扩展的信息；同时记下页面里Loaded Configuration File字段显示的Web环境php.ini路径。
• 打开终端，运行php --ini查看CLI模式下的php.ini路径，再运行php -m确认是否有rdkafka扩展。

如果两个环境的php.ini路径不一样，那问题就找到了——你只在CLI的php.ini里加载了RdKafka，Web环境的配置文件根本没加。

2. 给Web环境的PHP配置添加RdKafka扩展 #

找到Web环境对应的php.ini文件，在里面添加一行：

extension=rdkafka.so  # Linux/macOS系统用这个
# Windows系统请用：extension=php_rdkafka.dll

保存后必须重启Web服务器/PHP-FPM进程，不然配置不会生效：

• 如果用Nginx+PHP-FPM：sudo systemctl restart php-fpm（注意替换成你的PHP版本，比如php8.1-fpm）
• 如果用Apache：sudo systemctl restart apache2

3. 排查其他可能的小问题 #

如果上面的步骤没解决，再检查这两个点：

• 权限问题：RdKafka扩展文件的权限是否允许Web服务器用户（比如www-data）读取？用ls -l /path/to/rdkafka.so查看，确保权限至少是644，如果不是就运行sudo chmod 644 /path/to/rdkafka.so。
• Laravel缓存问题：有时候配置缓存会导致类加载异常，运行下面的命令清除缓存再试：

  php artisan config:clear
  php artisan cache:clear
  

补充说明 #

你提到错误提示是找不到RdKafka\Producer，但给出的代码里用的是RdKafka\TopicConf——不管是哪个类，本质都是RdKafka扩展没在Web环境加载，所以上面的排查步骤完全通用。

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