ArgumentCountError 是 PHP 7.1+ 将参数不足错误升级为致命错误，需确保函数调用时传入声明的必需参数，如 OrderShipped::__construct() 明确要求 1 个 User 实例，调用时必须传入有效对象而非空或错误类型。
这个错误不是 PHP 在“挑刺”，而是明确告诉你：函数定义了几个必需参数，你调用时没给够。PHP 7.1+ 把这类问题从警告升级为 ArgumentCountError，直接中断执行——所以必须修，不能忽略。
看清楚报错里是哪个函数、缺几个参数
错误信息像这样：Fatal error: Uncaught ArgumentCountError: Too few arguments to function App\Mail\OrderShipped::__construct(), 0 passed in ... and exactly 1 expected。重点抓三处：
-
OrderShipped::__construct()：出问题的是这个构造方法 -
0 passed：调用时一个参数都没传 -
exactly 1 expected：它声明了一个必需参数（比如$user）
别急着改代码，先确认调用点在哪。常见位置有：
- Laravel 的
Mail::to(...)->send(new OrderShipped(...)) - Excel 导出：
Excel::download(new ReportExport, ...) - 控制台命令中
new SomeService(...) - 手动 new 类的任何地方
构造函数参数不匹配：传参 vs 声明要对得上
最典型场景是 Mailable 或 Export 类的 __construct()。比如你写了：
立即学习“PHP免费学习笔记（深入）”；
class OrderShipped extends Mailable
{
public function __construct(User $user)
{
$this->user = $user;
}
}
但调用时写成了 new OrderShipped() 或 new OrderShipped($username)（而 $username 是未定义变量），就会报错。解决方式很直接：
- 确保调用时传入的变量已存在且类型匹配（
$user是User实例，不是字符串） - 如果参数确实可选，加默认值：
public function __construct(User $user = null)，但注意后续逻辑要处理null情况 - 不要依赖“PHP 会自动注入”——Laravel 的自动注入只发生在容器解析的上下文中（如控制器方法、命令类的
handle()），不适用于new Xxx()手动实例化
控制器或命令方法参数丢失：路由没传进来
比如报错 Too few arguments to function App\Http\Controllers\DataPegawaiController::storeDetail(), 1 passed and exactly 2 expected，方法定义是 public function storeDetail($id, Request $request)，但实际只收到了 Request。这不是代码写错了，是 Laravel 没把路由参数 {id} 绑定过去。原因通常是：
- 路由参数名
{id}和方法参数名$id不一致（比如写成$userId就失效） - 用了类型提示（如
Request $request）后，前面的普通参数（$id）被跳过解析——这是 Laravel 的行为限制 - 中间件提前终止了请求，或路由没匹配到
稳妥做法是放弃依赖自动绑定 $id，改用 $request->route('id') 显式取值，方法签名只留 Request $request 一个参数。
自定义函数/方法里误加了必需参数
特别是 getter 方法，比如 function get_name($name) { return $this->name; } —— 这个 $name 参数完全没必要，还强制调用方传值。删掉它，改成 function get_name() { return $this->name; } 即可。
另一个常见坑：函数定义了默认参数，但你调用时传了 null。注意 PHP 不会因此回退到默认值，null 就是传进去了。只有完全不传，才会用默认值。
最麻烦的其实是那些“看起来该自动注入，其实不会”的地方——比如在非容器管理的类里写 new Service($dep)，却指望框架塞参数进来。这时候错误不是语法问题，而是对 Laravel 生命周期和依赖注入边界的误解。
