laravel 10+ 升级后 artisan 命令需强制在 configure() 中声明参数，否则 handle() 调用 $this->argument() 会报“参数不存在”错误；命令注册改由 bootstrap/app.php 的 withcommands() 控制，$commands 数组方式须确保为类名字符串，且必须清除配置缓存。
升级 Laravel 后 php artisan 命令突然报错或行为异常，大概率不是命令写错了，而是命令签名、参数绑定或服务注册时机变了——尤其在 9.x → 10.x 或 10.x → 11.x 升级后。
Artisan 命令类的 configure() 和 handle() 被强制拆分
Laravel 10+ 要求所有自定义命令必须显式声明参数与选项（通过 configure()），不再允许在 handle() 中用 $this->argument() 动态读取未声明项。旧代码跑起来会报 InvalidArgumentException: The "xxx" argument does not exist.
- 旧写法（Laravel 8/9）：
handle()里直接调$this->argument('name') - 新写法（Laravel 10+）：必须在
configure()中调$this->addArgument('name', InputArgument::REQUIRED) - 不改会报错，且错误信息不提示“你漏了 configure”，只说参数不存在——容易误判为传参问题
php artisan list 不显示自定义命令
常见于升级后清除了缓存但没重发布命令注册逻辑。Laravel 10+ 开始，命令自动发现依赖 bootstrap/app.php 中是否启用了 withCommands()，而不是靠 app/Console/Kernel.php 的 $commands 数组。
- 检查
bootstrap/app.php是否包含->withCommands(__DIR__.'/../app/Console/Commands') - 如果仍用传统
$commands数组方式，需确认该数组值是类名字符串（如'App\Console\Commands\SendReports'），不能是实例或闭包 - 执行
php artisan config:clear和php artisan clear-compiled（Laravel 9+ 可能需php artisan opcache:clear）
php artisan make:command 生成的模板变了
Laravel 10+ 默认生成带 configure() 的命令类，且默认使用 Illuminate\Console\Command（而非旧版继承 Command 别名），同时移除了 fire() 方法支持。
- 生成后别急着写逻辑，先看顶部注释里是否已含
configure()框架 - 若手动复制旧命令代码，记得删掉残留的
fire()方法——它已被完全废弃，存在会导致BadMethodCallException - 参数类型提示现在更严格：
string $name会触发类型校验，而旧版靠InputArgument::REQUIRED控制，不匹配时抛出TypeError
最麻烦的不是语法报错，而是某些命令在升级后“看似运行成功”，实则跳过了关键参数校验——比如原本靠 if (!$this->argument('force')) return; 挡住的操作，现在因参数未声明，$this->argument('force') 返回 null 而非抛错，逻辑就悄悄绕过去了。
