Yii2控制台命令需通过系统Cron调用，关键点包括：使用绝对路径调用PHP和yii、显式cd到项目根目录、正确编写时间表达式、重定向日志、控制器继承yii\console\Controller且方法为actionXXX形式、确保console.php中正确配置controllerNamespace或controllerMap、避免依赖Web组件。
Yii2 控制台命令怎么注册成系统 Cron
直接写好 yii 命令后，它不会自动跑，必须由系统级 Cron 调用。常见错误是只在本地执行 php yii my-task/index 测试成功，就以为部署完事了。
实操建议：
- 确认 PHP CLI 路径：用
which php查，别用 Apache 或 Nginx 的 PHP；Cron 里必须写绝对路径，比如/usr/bin/php /var/www/yii my-task/index - Cron 时间表达式别写错：例如每 10 分钟执行一次，应为
*/10 * * * *，不是0 */10 * * *（后者是每小时第 0 分钟，即整点） - 工作目录很重要：Cron 默认 cwd 是用户 home，
yii命令需在项目根目录下运行，建议在 Cron 中显式 cd：*/10 * * * * cd /var/www/myapp && /usr/bin/php yii my-task/index - 日志务必重定向：不加
> /dev/null 2>&1或指定日志文件，失败时完全看不到错误，推荐> /var/log/myapp-cron.log 2>&1
Console 控制器里怎么写可被调用的任务逻辑
Yii2 控制台任务本质就是继承 yii\console\Controller 的类，方法名必须是 actionXXX 形式，且不能带参数（Cron 不传参，所有配置走配置项或环境变量）。
常见错误现象：写了 public function run() 或 public function execute()，结果命令找不到；或者 action 方法里用了 Yii::$app->request —— 控制台没 request 组件。
实操建议：
- 控制器放在
commands/目录下，类名如MyTaskController，对应命令就是my-task（小写中划线） - 避免在 action 中硬编码路径，用
Yii::getAlias('@runtime')或Yii::getAlias('@app') - 数据库操作要显式开启事务并捕获异常：控制台命令崩溃不会自动回滚，
try { $transaction = Yii::$app->db->beginTransaction(); ... $transaction->commit(); } catch (\Exception $e) { $transaction->rollBack(); throw $e; } - 如果需要传参（如 --env=prod），用
$this->options定义，再通过$this->option('env')获取，别解析$argv
为什么定时任务总不执行或报 Class not found
最常踩的坑是环境不一致：Web 和 Console 共享配置但加载逻辑不同，尤其涉及 autoloading、bootstrap、模块注册时。
典型表现：浏览器访问正常，Cron 执行时报 Class 'xxx' not found 或 Unknown command。
原因和对策：
-
Unknown command：没在config/console.php的'controllerMap'或'controllerNamespace'里正确声明控制器命名空间，检查是否漏了'commands' => 'app\commands' -
Class not found：Composer autoloader 没生效，确保 Cron 调用的是项目根目录下的vendor/autoload.php，而不是全局的；可在入口脚本顶部加var_dump(__DIR__)确认当前路径 - 依赖 Web 组件（如
Yii::$app->user）：控制台应用默认不加载 user、session、urlManager 等组件，要用就得在console.php显式配置，但通常没必要 —— 换成查 DB 或发消息更合理 - 时区错乱：Cron 使用服务器时区，PHP 脚本里用
date_default_timezone_set('Asia/Shanghai')显式设，别依赖 ini 设置
要不要用 yii2-cron 或其他扩展
绝大多数场景不需要。Yii2 原生控制台 + 系统 Cron 已足够稳定，加一层扩展反而增加维护成本和兼容风险。
只有当出现这些情况才考虑：
- 需要动态启停任务（比如后台开关）、记录每次执行状态、可视化失败重试 —— 这时该上专门的任务队列（如 Redis + yii2-queue）
- 任务间有强依赖（A 完成才跑 B），且频率高（秒级）、数量大（百级/分钟）—— 系统 Cron 不适合编排，得换 workflow 引擎
- 团队不熟悉 Linux，运维不愿配 Cron —— 可临时用
yii schedule/run配合常驻进程，但要注意内存泄漏和僵尸进程
扩展如 yii2-cron 实际只是封装了 Cron 表达式解析和命令注册，底层仍靠系统 Cron 触发，没解决任何根本问题。
真正容易被忽略的是：Cron 日志权限、磁盘满导致 runtime 文件写失败、数据库连接池耗尽却没超时设置 —— 这些比“用不用扩展”影响大得多。
