Laravel队列任务被分发至default队列而非指定队列问题排查

• 常驻队列进程未重启/代码缓存问题
  这是最高发的诱因：Laravel的queue:work是常驻内存进程，启动后会把加载到的代码长期驻留内存，不会主动读取磁盘上更新后的代码。如果你写完$this->onQueue('billing')逻辑后没有重启队列监听进程，或者服务器OPcache没有刷新，进程实际运行的还是旧版本的任务代码，根本没执行指定队列的逻辑，就会自动fallback到默认的default队列。
• 类属性/引入trait的默认值覆盖
  检查DoBilling类的头部属性定义、以及类引入的所有trait：如果存在直接声明的public $queue = 'default'属性，部分框架底层分发逻辑、或者第三方包提供的trait会在构造函数执行完成后，用类的默认属性值覆盖你在构造函数中设置的队列名。
• 第三方队列组件的路由规则覆盖
  如果你项目中使用了Laravel Horizon或者其他队列增强扩展包，检查对应配置文件是否开启了任务自动路由：部分扩展支持按任务命名空间、类名自动分配队列，这类路由规则的优先级通常高于任务构造函数内的设置，会把匹配到的任务强制路由到default队列。
• dispatch逻辑被自定义代码覆盖
  检查项目中是否存在自定义重写的dispatch()辅助函数、或者给队列Dispatcher注册了分发宏、前置拦截钩子：这类自定义逻辑如果在分发任务时没有判断任务本身已经设置的队列属性，直接给任务重新赋值queue属性为default，就会覆盖你之前的配置。
• 队列名字符串存在异常字符
  检查你传入onQueue()的billing字符串是否存在不可见字符，比如首尾空格、换行符、全角字符。如果队列名实际值和你预期的billing不一致，部分队列驱动会把无法匹配路由规则的任务直接归到default队列下。
• 魔术方法拦截了属性赋值
  检查DoBilling类、父类以及引入的trait中是否定义了__set()魔术方法：如果魔术方法拦截了对queue属性的赋值，会导致你调用onQueue('billing')时并没有真正把队列名写入$queue属性，任务分发时就会使用默认队列值。

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