队列任务中无法获取当前租户是因为异步执行时租户上下文未继承，正确做法是在 dispatch 时显式传入 tenant_id，并在 handle() 中调用 Tenant::set($tenantId)、Tenant::sync() 及 DB::reconnect('tenant') 等手动切换租户环境。
队列任务里拿不到当前租户怎么办
因为 Laravel 队列是异步执行的，tenant() 或 Tenant::current() 在任务 handle 里大概率返回 null —— 队列 worker 启动时没加载租户上下文，后续也不会自动继承。
核心解法：把租户标识（比如 tenant_id）显式传进去，而不是依赖运行时上下文。
- 在 dispatch 时带上租户 ID：
ProcessOrder::dispatch($order)->onQueue('default')->tenantId($tenant->id)（前提是用了spatie/laravel-multitenancy或类似包，且已扩展了tenantId()方法） - 更通用的做法：直接作为参数传入：
ProcessOrder::dispatch($order, $tenant->id)，然后在handle()里用Tenant::find($tenantId)主动切换 - 别在
__construct()里调tenant()—— 构造函数在 dispatch 时就执行，此时上下文还没进队列，值不可靠
用 tenant()->run() 包裹 handle 逻辑是否安全
不安全。Laravel 的 tenant()->run() 是同步上下文切换，但队列任务可能跨进程、跨机器执行，run() 只影响当前请求生命周期，对队列 worker 无意义。
真正起作用的是初始化租户连接和文件系统路径等——这些必须在任务开始时重新 setup。
- 推荐在
handle()开头手动切换：Tenant::set($tenant); Tenant::sync();（以 spatie 包为例） - 数据库连接要重连：
DB::reconnect('tenant')或确保配置中'tenant' => ['prefix' => 'tenant_']已生效 - 如果用了缓存前缀或文件磁盘隔离，也要在
handle()里重置Cache::store('tenant')或Storage::disk('tenant')
为什么监听队列时租户数据全乱了
常见于多租户共用一个队列 worker 进程，且没有为每个任务重置租户状态。worker 启动后会复用连接、缓存、配置实例，上一个任务的 tenant_id 可能残留到下一个任务里。
根本原因不是队列本身，而是状态没清理干净。
- 确保每次
handle()执行前都显式调用Tenant::forgetCurrent()（或等效方法） - 避免在
AppServiceProvider或中间件里全局绑定租户，队列环境不走 HTTP 生命周期 - 检查是否用了
cache:clear后未重载租户配置 ——php artisan tenancy:migrate和tenancy:sync要在部署后跑一次
ShouldQueue 接口 + 多数据库连接怎么配才不串库
默认 Laravel 不会为队列任务自动切换 DB 连接，哪怕你已经设置了 tenant()->database，它只影响当前请求的连接池，而队列用的是独立连接。
必须让每个任务自己决定用哪个连接，并强制断开旧连接。
- 在
handle()开头加：DB::purge('tenant'); DB::reconnect('tenant'); - 模型查询时显式指定连接：
Order::on('tenant')->where(...)->get() - 如果用到了
DB::transaction()，务必写成DB::connection('tenant')->transaction(...)，否则默认走mysql主连接 - 注意迁移命令
php artisan migrate --database=tenant不会影响队列运行时行为，只是初始化用
最易被忽略的一点：队列任务里的 Eloquent 模型软删除、时间戳、事件监听器，全都依赖当前连接的数据库前缀和表结构 —— 租户表名不一致时，没切对连接就会查错表、删错数据。
