必须将邮件发送逻辑移至队列异步执行，因同步调用send()在高延迟SMTP下会阻塞关键路径；队列任务需在CLI进程正确加载autoloader、复用Yii::$app->mailer、仅传原始数据（如收件人、模板名、参数数组），并在execute()中完成模板渲染与时区等环境初始化。
直接用 yii\swiftmailer\Mailer 同步发邮件，在用户注册、下单等关键路径上会明显卡顿，尤其当 SMTP 延迟高或网络抖动时，send() 可能阻塞数秒。必须把发送逻辑挪到队列里异步执行——但光推任务进队列不等于就稳了，常见失败点全在环境隔离和类加载上。
为什么 Swift_SmtpTransport 在队列进程里报错找不到？
Web 请求时 Composer autoloader 已加载 swiftmailer/swiftmailer，但 CLI 进程（比如 php yii queue/listen）没自动引入 vendor/autoload.php。特别是用 Supervisor 管理队列进程时，容易漏掉这行初始化代码。
- 检查你的队列启动命令是否显式包含
require __DIR__.'/vendor/autoload.php'; - 确认
console.php配置中'queue'组件的redis或db连接参数在 CLI 下可连通（比如 Redis 密码、数据库账号权限） - 别在
execute()里重复调用\Yii::createObject()创建 Mailer 实例——直接复用\Yii::$app->mailer更安全，它已在 console 应用启动时完成初始化
SendEmailJob 类里该传什么数据、不该传什么？
Job 类是序列化后存进队列的，不能传 Closure、resource、PDO 实例等不可序列化对象。只传原始数据：收件人邮箱、模板名、参数数组。
- ✅ 推荐传：
$this->to（字符串）、$this->template（如'welcome'）、$this->params（关联数组，如['name' => 'Alice']） - ❌ 禁止传：
$this->mailer、$this->userModel、new \DateTime()（对象实例） - 模板渲染必须在
execute()内完成，不能在 Web 层 render 好 HTML 再传进去——否则模板路径、主题配置、i18n 环境都对不上
用 Cron 跑 queue/listen 还是长连接守护进程？
两者都能用，但行为差异很大：
- Cron 每分钟拉起一次
php yii queue/listen --verbose --color：适合低频任务（如每小时发一次报表），启动开销小，崩溃自动恢复，但延迟高（最多 60 秒） - Supervisor 守护
php yii queue/listen：实时消费，延迟毫秒级，但需确保进程常驻——要加autorestart=true和stderr_logfile查日志 - 无论哪种，都得在
execute()开头加set_time_limit(0)，避免大附件或慢 SMTP 导致超时中断
最易被忽略的是：队列 Job 执行时的 PHP 环境与 Web 完全隔离，$_SERVER、$_ENV、当前工作目录、甚至时区设置都可能不同。发邮件前务必用 date_default_timezone_set('Asia/Shanghai') 显式设时区，模板里用 Yii::t() 前确认 i18n 组件已正确加载。
