thinkphp定时命令不执行的根本原因是schedule:run仅扫描app/command下继承think\console\command且显式注册（5.1）或注解声明（6.x）的类；亚分钟级需用系统cron每分钟触发或守护进程；参数须设默认值，日志需指定cli通道，失败须显式exit。
为什么 php think schedule:run 不执行自定义命令
根本原因不是调度没配，而是 ThinkPHP 的 schedule:run 默认只扫描 app/command 下的类，且要求类必须继承 think\console\Command 并显式注册到 app/console.php（5.1）或通过注解/配置声明（6.x）。漏掉任一环节，命令就“存在但不可见”。
实操建议：
- 确认命令类文件放在
app/command/YourTask.php，类名是YourTask，命名空间为app\command - ThinkPHP 6.x 必须在类顶部加
@command注解：/** * @command your:task */
- ThinkPHP 5.1 需手动在
app/console.php中返回数组，包含'your:task' => 'app\command\YourTask' - 运行
php think list，确认你的命令出现在输出里——这是唯一可信的验证方式
如何让定时任务真正“按秒级”触发
ThinkPHP 原生 schedule 是基于 Cron 的分钟级调度器，* * * * * 最小粒度就是 1 分钟。想实现每 10 秒跑一次？不能靠改 Cron 表达式，得绕开它。
实操建议：
- 用系统 Cron 每分钟拉起一次
php think schedule:run，这是官方推荐方式，别试图用sleep(10)在 PHP 进程里硬轮询 - 若真需亚分钟级，单独写一个守护进程脚本（如用
while(true)+sleep(10)），调用你的命令逻辑，再用supervisor管理生命周期 - 注意：多个并发执行可能导致任务重叠，务必在命令开头加文件锁或数据库标记，例如检查
cache('your_task_lock')是否存在
think\console\Command 中获取参数和选项的坑
很多人把 $this->argument('name') 和 $this->option('force') 当成普通变量直接用，结果在未传参时抛出异常或返回 null，而不是预期的默认值。
实操建议：
- 始终用第二个参数设默认值：
$this->argument('date', 'today')、$this->option('dry-run', false) - 判断参数是否存在，用
$this->hasArgument('date')而不是empty($this->argument('date'))，因空字符串也是合法输入 - 选项（
--force）不传时返回null，传了但没值（如--force）返回true，传了带值（--force=1）才返回'1' - 别在
configure()里调用argument()或option()，此时输入尚未解析，一律返回null
日志写入失败或内容被截断
命令行任务默认不走 Web 的日志通道，Log::info() 可能静默丢弃，或者写进 runtime/log/cli/ 却没人看，更糟的是大文本被 file_put_contents 的默认模式覆盖而非追加。
实操建议：
- 强制指定日志通道：
Log::channel('cli')->info('start')，并在config/log.php中配好cli驱动，路径建议设为runtime/log/cli/ - 避免用
echo或var_dump输出调试信息——它们可能被管道截断或混入 cron 邮件通知中 - 写大日志前先检查磁盘空间，用
disk_free_space()防止写满导致命令卡死 - 敏感字段（如密码、token）绝不能打到日志里，命令行日志更容易被运维直接翻看
最常被忽略的一点：命令类的 execute() 方法返回值不会影响退出码，必须显式调用 $this->error() 或 exit(1) 才能让上层系统（比如 Cron）感知失败。别以为抛异常就够了——异常未被捕获时进程直接退出，Cron 只看到非零状态码，但你没法控制具体码值。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
