Laravel 12 为事件绑定多个监听器时触发「First array member is not a valid class name or object」错误的求助

最近有开发者在Laravel 12中尝试给OTPVerificationEvent事件绑定多个监听器时，碰到了「First array member is not a valid class name or object」的错误，下面是他的尝试代码、问题分析和解决方案：

尝试的代码实现 #

1. AppServiceProvider.php 中的事件绑定代码

<?php

namespace App\Providers;

use App\Events\Frontend\OTPVerificationEvent;
use App\Listeners\Frontend\{OTPOnMobileListener, OTPOnWhatsappListener};
use Illuminate\Support\Facades\Event;
use Illuminate\Support\ServiceProvider;

class AppServiceProvider extends ServiceProvider
{
    /**
     * Register any application services.
     */
    public function register(): void
    {
        //
    }

    /**
     * Bootstrap any application services.
     */
    public function boot(): void
    {
        // 尝试写法1：嵌套数组包裹监听器实例
        Event::listen(OTPVerificationEvent::class, [
            [new OTPOnMobileListener, 'handle'],
            [new OTPOnWhatsappListener, 'handle'],
        ]);

        // --- OR ---
        // 尝试写法2：直接传递监听器对象数组
        Event::listen(OTPVerificationEvent::class, [
            new OTPOnMobileListener,
            new OTPOnWhatsappListener,
        ]);

        // --- OR ---
        // 尝试写法3：传递监听器类名字符串数组
        Event::listen(OTPVerificationEvent::class, [
            OTPOnMobileListener::class,
            OTPOnWhatsappListener::class,
        ]);
    }
}

2. OTPVerificationEvent.php 事件类

<?php

namespace App\Events\Frontend;

use Illuminate\Broadcasting\Channel;
use Illuminate\Broadcasting\InteractsWithSockets;
use Illuminate\Broadcasting\PresenceChannel;
use Illuminate\Broadcasting\PrivateChannel;
use Illuminate\Contracts\Broadcasting\ShouldBroadcast;
use Illuminate\Foundation\Events\Dispatchable;
use Illuminate\Queue\SerializesModels;

class OTPVerificationEvent
{
    use Dispatchable, InteractsWithSockets, SerializesModels;

    /**
     * Public variables
     */
    public $mobile;
    public $mobileOtp;
    public $whatsappOtp;

    /**
     * Create a new event instance.
     */
    public function __construct($mobile, $mobileOtp, $whatsappOtp)
    {
        $this->mobile = $mobile;
        $this->mobileOtp = $mobileOtp;
        $this->whatsappOtp = $whatsappOtp;
    }

    /**
     * Get the channels the event should broadcast on.
     *
     * @return array<int, \Illuminate\Broadcasting\Channel>
     */
    public function broadcastOn(): array
    {
        return [
            // new PrivateChannel('channel-name'),
        ];
    }
}

3. OTPOnMobileListener.php 监听器

<?php

namespace App\Listeners\Frontend;

class OTPOnMobileListener
{
    /**
     * Handle the event.
     */
    public function handle(object $event): void
    {
        echo "<pre>";
        print_r($event);
        echo "</pre>\n";
        exit;
    }
}

4. OTPOnWhatsappListener.php 监听器

<?php

namespace App\Listeners\Frontend;

class OTPOnWhatsappListener
{
    /**
     * Handle the event.
     */
    public function handle(object $event): void
    {
        echo "<pre>";
        print_r($event);
        echo "</pre>\n";
        exit;
    }
}

错误原因分析 #

1. 写法1的嵌套数组格式错误：[[new OTPOnMobileListener, 'handle'], ...]这种嵌套数组的写法不符合Laravel事件监听器的绑定规范，框架无法识别这种嵌套结构的监听器定义，这是触发错误的主要原因。
2. 写法2的对象数组存在隐患：直接传递监听器对象虽然语法上可行，但如果监听器依赖容器注入的服务，提前实例化对象会导致依赖注入失效，而且也不是Laravel推荐的方式。
3. 写法3本身格式正确，但监听器代码有问题：比如handle方法的参数类型不严谨、监听器中的exit语句会中断流程，可能让开发者误以为绑定失败。

正确的解决方案 #

1. 推荐的事件绑定写法

直接传递监听器类名字符串数组即可，这是Laravel官方推荐的绑定多个监听器的标准方式：

Event::listen(OTPVerificationEvent::class, [
    OTPOnMobileListener::class,
    OTPOnWhatsappListener::class,
]);

2. 监听器代码的优化

• 修正handle方法的参数类型提示，把object替换为具体的事件类，这样更严谨还能获得IDE的类型提示：

// OTPOnMobileListener.php
public function handle(OTPVerificationEvent $event): void
{
    echo "<pre>";
    print_r([
        '手机号' => $event->mobile,
        '短信验证码' => $event->mobileOtp
    ]);
    echo "</pre>\n";
}

// OTPOnWhatsappListener.php
public function handle(OTPVerificationEvent $event): void
{
    echo "<pre>";
    print_r([
        '手机号' => $event->mobile,
        'WhatsApp验证码' => $event->whatsappOtp
    ]);
    echo "</pre>\n";
}

• 移除监听器中的exit语句：exit会直接终止PHP进程，导致后续的监听器无法执行，只有去掉exit，两个监听器才会依次运行。

3. 触发事件的测试

在控制器或其他业务代码中触发事件，验证两个监听器是否正常执行：

use App\Events\Frontend\OTPVerificationEvent;

// 触发事件
event(new OTPVerificationEvent('13800138000', '123456', '654321'));

执行后，两个监听器会依次输出对应的验证码信息，不会再出现「First array member is not a valid class name or object」的错误。

内容来源于stack exchange