ThinkPHP 5.1 需手动注册命令且不支持子目录扫描，TP6 改为服务提供者自动发现并依赖扩展包；定时任务机制、MySQL 元数据查询兼容性及容器注入方式均存在跨版本差异。
ThinkPHP 5.1 的 php think 命令不识别自定义命令？
默认情况下，TP5.1 的命令行工具只加载 app/command 目录下继承 thinkCommand 的类，且类名必须与文件名一致（如 SendEmail.php 对应 appcommandSendEmail），同时需在 app/command.php 配置文件中显式注册。
常见错误是直接放类文件却没注册，导致 php think list 看不到新命令；或者命名空间写错（比如漏了 appcommand），运行时报 Class not found。
- 确保类文件路径为
app/command/SendEmail.php - 类定义开头必须是
namespace appcommand;，不能用appcommandsendemail小写 - 在
app/command.php中添加'appcommandSendEmail'到数组里 - TP5.1 不支持自动扫描子目录，
app/command/tool/下的命令不会被发现
ThinkPHP 6.x 的 console 命令为什么找不到 make:controller？
TP6 默认禁用了部分开发向命令（如 make: 系列），它们被移到了独立扩展包 topthink/think-multi-app 或需手动安装 topthink/think-orm（旧版）及对应命令扩展。更关键的是：TP6 的命令注册机制从「配置数组」改为「服务提供者自动发现」，依赖 composer.json 的 autoload 和 extra.think-command 声明。
典型现象是执行 php think make:controller User 报错 There are no commands defined in the "make" namespace.。
立即学习“PHP免费学习笔记（深入）”；
- 先确认是否已安装
topthink/framework6.1+，再执行composer require topthink/think-multi-app（TP6.1+ 推荐） - 检查
composer.json中是否有"extra": {"think-command": ["think\command\MakeCommand"]}（手动注册时需要） - TP6.3+ 开始，
make:命令默认由think-orm提供，但仅当项目启用了 ORM 组件才加载——若你用的是 Db 类而非 Model，该命令仍不可用 -
php think list输出中没有make:前缀命令，基本可断定命令扩展未生效
TP5.1 和 TP6 在定时任务调度上的命令调用差异
两者都支持通过 php think timer:run 启动定时器，但底层机制完全不同：TP5.1 是单次轮询 + 内存缓存任务列表，TP6 改为基于 Swoole 或 Workerman 的常驻进程模型（需额外安装扩展），且命令参数和回调注册方式不兼容。
例如你在 TP5.1 写的 $this->app->command->run('php think task:sync')，在 TP6 中不能直接复用——TP6 的定时任务必须通过 thinkswooleTimer 或 think acadeConsole 调用，且命令本身需声明为可异步执行（加 protected $asynchronous = true;）。
- TP5.1 定时命令本质是 shell 脚本调用，适合低频、轻量任务；TP6 更适合高频、长时任务，但对服务器环境有要求（如需 Swoole 扩展）
- TP6 的
timer:run不会自动重载命令类，修改命令逻辑后必须重启定时器进程 - 跨版本迁移定时任务时，别只改命令名，重点检查回调函数是否还依赖
thinkCache这类在常驻进程中行为变化的组件
为什么 TP6 的 php think optimize:schema 在 MySQL 8.0+ 报错？
这个命令在 TP6.0–6.2 中默认使用 information_schema.COLUMNS 查询字段元数据，而 MySQL 8.0 默认开启 sql_mode=STRICT_TRANS_TABLES,NO_ENGINE_SUBSTITUTION，某些字段（如 JSON 类型的默认值）会导致查询失败，报错类似 Invalid default value for 'data'。
这不是 ThinkPHP 的 bug，而是命令生成的 SQL 与 MySQL 严格模式不兼容。TP6.3+ 已修复，但大量线上项目卡在 6.2。
- 临时解决：在数据库连接配置中追加
'params' => [PDO::ATTR_EMULATE_PREPARES => true]，或手动关闭 strict mode（不推荐生产环境） - 根本办法：升级到 TP6.3+，并确认
think-orm版本 ≥ 2.0.42 - 注意：该命令生成的 schema 缓存文件（
runtime/schema/）在不同 MySQL 版本间不可复用，切勿直接拷贝
命令行工具不是“写一次跑所有版本”的黑盒，每个大版本的命令注册、生命周期、依赖注入时机都变了——最常被忽略的是“命令类是否被容器管理”，TP6 中没被 bind() 或自动注入的命令，$this->app 可能为空。
