必须在app/command.php中显式注册完整类名（如'app\command\syncdata'），且命令类须继承think\console\command、置于app/command/目录、命名空间为app\command、类名与文件名严格一致，否则php think your:command将报“command not defined”。
ThinkPHP 6 的 think 命令如何正确触发自定义命令
直接运行 php think your:command 失败，大概率是命令类没注册或命名空间写错。ThinkPHP 6 要求命令类必须继承 think\console\Command，且需在 app/command.php 中显式注册（TP6.0+ 默认不自动扫描），否则 think list 根本看不到你的命令。
实操建议：
- 命令类路径建议统一放在
app/command/下，例如app/command/SyncData.php - 类名必须与文件名一致，命名空间为
app\command，不能漏掉use think\console\Command; - 注册方式：在
app/command.php返回数组中加入'app\command\SyncData' - 调试时先执行
php think list，确认命令出现在列表里再跑
Linux 下用 crontab 调度 php think 的权限与路径陷阱
常见错误是 cron 执行时报 Class not found 或 require(): failed to open stream —— 这不是代码问题，而是 cron 环境缺失 PHP CLI 配置和项目根目录上下文。
实操建议：
- 绝对不用相对路径：crontab 中必须写完整路径，如
/usr/bin/php /var/www/myapp/think sync:data - 显式指定 PHP 可执行文件路径（
which php查），避免系统默认用 cgi 版本 - 加
cd /var/www/myapp &&前缀，确保 autoload 和配置加载正常 - 重定向日志：追加
> /var/log/tp-cron.log 2>&1，方便查错 - 注意环境变量差异：cron 默认 PATH 极简，不要依赖
~或未声明的别名
Scheduler 类里 call() 和 exec() 的本质区别
TP6 自带的调度器（think\scheduler\Scheduler）中，call() 是调用 PHP 方法，exec() 是起新进程执行 shell 命令 —— 这直接影响能否共享数据库连接、事务、内存状态。
实操建议：
- 用
call('app\service\TaskService::doBackup')适合轻量、需复用当前应用上下文的操作（如 Model 查询、事件触发） - 用
exec('php think backup:db')适合耗时长、要隔离进程的任务（如导出大文件、调外部 CLI 工具），避免阻塞主调度进程 -
call()抛异常会中断整个调度周期；exec()即使失败也不会影响后续任务，但错误不会自动捕获 - 二者都支持
everyMinute()等频率链式调用，但call()不支持onOneServer()（分布式锁需自行实现）
生产环境调度任务卡住不执行的三个隐蔽原因
任务注册了、crontab 写对了、日志也没报错，但就是不跑 —— 往往卡在锁机制、单例生命周期或框架初始化阶段。
实操建议：
- 检查
runtime/schedule.lock文件是否残留（尤其开发时 Ctrl+C 中断后），手动删掉再试 - 确认
config/schedule.php中的'enable' => true，TP6 默认关闭调度器 - 避免在命令的
configure()或handle()里做耗时初始化（如读大配置文件、连 Redis），应改到handle()内部按需加载 - 如果用了 Swoole 或常驻进程模式，
think:scheduler无法工作 —— 它只适配传统 CLI 模式
调度不是“写完就跑”，真正麻烦的是环境一致性、进程隔离和失败静默。每次改完记得清 runtime/ 下的 cache 和 lock 文件，不然它可能假装在运行。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
