Laravel对接Firebase FCM报错：消息仅能指定一个发送目标

该报错由两层规则限制共同触发：

1. Firebase Cloud Messaging 官方接口硬限制：单条推送消息仅允许指定condition、token、topic、unknown四类目标中的唯一一类，同时配置多类目标时接口会直接返回参数错误响应。
2. 使用laravel-notification-channels/fcm扩展包构造推送消息时，给消息体同时赋值了两类及以上的目标字段，扩展包捕获FCM接口的错误响应后，就会抛出CouldNotSendNotification异常，对应你看到的错误提示。

常见触发场景：

• 通知类toFcm()方法中，既调用setToken()/setTokens()指定了推送设备，又同时调用setTopic()/setCondition()配置了主题或主题条件
• 复用Fcm消息实例做多次发送时，没有清空上一次发送赋值的目标字段，导致多个目标字段同时存在有效值
• 误写配置时同时给多个目标字段传入了空字符串、null以外的有效值

• 梳理通知类中toFcm($notifiable)方法的消息构造逻辑，严格保证单条消息仅配置一类目标：
  • 推送到指定设备：仅调用setToken()（单设备）或setTokens()（批量设备，单次最多支持500个token），不要配置topic、condition相关参数
  • 推送到指定主题：仅调用setTopic('目标主题名')，不要传入设备token或条件表达式
  • 推送到满足主题组合条件的设备群：仅调用setCondition('主题条件表达式')，不要配置其他目标字段
• 如果存在复用Fcm消息实例的逻辑，每次构造新消息前要重置所有目标字段，避免历史赋值残留。
• 若业务需要同时给设备、主题等不同目标发送相同内容的通知，需构造多条独立的消息分别发送，不可在同一条消息内配置多目标。

正确的消息构造示例代码：

public function toFcm($notifiable)
{
    // 错误示例：同时配置token和topic，必然触发报错
    // return FcmMessage::create()
    //     ->setToken($notifiable->fcm_token)
    //     ->setTopic('system_announce')
    //     ->setNotification(/* 通知内容配置 */);

    // 正确示例：仅指定设备token作为推送目标
    return FcmMessage::create()
        ->setToken($notifiable->fcm_token)
        ->setNotification(
            \NotificationChannels\Fcm\Resources\Notification::create()
                ->title('通知标题')
                ->body('通知正文内容')
        );
}

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