artisan命令不生效主因是未在kernel.php中注册；自定义命令需手动添加到$commands数组或启用自动发现；数据库操作须在handle()中执行；调度任务应使用command()或call()；参数需在$signature明确定义。
为什么 php artisan 命令不生效，或者自定义命令没被识别？
Artisan 命令没注册进内核，是新手最常卡住的地方。Laravel 不会自动扫描 app/Console/Commands 下的所有类——必须显式注册到 app/Console/Kernel.php 的 $commands 数组里。
- 确保你的命令类已通过
php artisan make:command XxxCommand创建（它会自动加命名空间和基础结构） - 手动在
app/Console/Kernel.php的$commands数组中添加完整类名：App\Console\Commands\XxxCommand::class - 如果用的是 Laravel 9+ 且启用了「命令自动发现」（
commands()方法存在），确认该方法未被注释或覆盖；但即便开启，也只扫描app/Console/Commands下的类，子目录不包含 - 运行
php artisan list后看不到命令？先清缓存：php artisan config:clear，再重试
如何在命令里安全访问数据库和 Eloquent 模型？
Artisan 命令默认运行在 console 环境下，但 Eloquent、DB 和配置加载都正常——前提是命令执行时框架已完全启动。问题多出在「过早调用」或「环境误判」。
- 不要在
__construct()中直接查数据库：此时服务容器可能尚未完全绑定，$this->model->get()可能报Call to a member function get() on null - 把逻辑移到
handle()方法里，这是 Laravel 确保容器就绪后的唯一入口点 - 注意
APP_ENV=production下部分命令会被限制（如migrate:fresh默认禁用），可在命令中用$this->confirm('确定要继续？')加交互保护 - 长时间运行的命令建议加
set_time_limit(0)，避免 CLI 超时中断（PHP 默认 30 秒）
schedule() 里的闭包为什么不执行，或报 Class not found？
Laravel 的任务调度本质是「在固定时间点触发 Artisan 命令」，不是直接调用 PHP 闭包。写在 schedule() 里的匿名函数，只有被包装成命令或调用 $schedule->call(...) 才真正有效。
- 错误写法：
$schedule->exec('php artisan foo')->daily();—— 这只是 shell 执行，不走 Laravel 生命周期，DB、日志、事件全不可用 - 正确路径有两条：
• 写一个真实命令类，然后$schedule->command('foo:bar')->daily()
• 或用$schedule->call(function () { /<em> 业务逻辑 </em>/ })->daily()，但注意：闭包内容不能含未序列化的对象（如 Eloquent 实例），也不能引用外部变量（除非用use ($var)显式捕获） - 调度依赖系统 cron：确保服务器上跑的是
<em> </em> <em> </em> * cd /path-to-app && php artisan schedule:run >> /dev/null 2>&1，而不是只靠本地php artisan schedule:work（后者仅开发调试用）
命令参数和选项怎么传，为什么 $this->argument('name') 总是 null？
Artisan 参数解析严格依赖命令签名（signature）定义。没声明，就拿不到；声明了但格式错，也会 fallback 为 null 或抛异常。
- 在命令类的
$signature属性里明确定义：foo:bar {name? : The name of the user} {--force : Force the operation to run}
其中{name?}表示可选参数，{name}是必填，{--force}是布尔选项 - 获取方式固定：
$this->argument('name')（参数）$this->option('force')（选项） - 常见坑：
• 把选项写成--force=true—— Laravel 不认等号，应写--force或--force=1（后者需在 signature 中声明为{--force=}）
• 参数名大小写不一致：{userName}和$this->argument('username')不匹配
• 使用php artisan foo:bar --help查看实际解析规则，比猜更可靠
命令调度、参数绑定、生命周期依赖——这些地方没有魔法，全是签名、注册、时机三者咬合的结果。漏掉任意一环，命令就停在半路。
