本文详解 laravel 9 下 `too few arguments to function app\mail\ordershipped::__construct()` 错误的成因与修复方案，重点解决因变量名不一致导致的构造函数调用失败问题，并提供完整可运行的代码示例。
该错误的核心原因在于 Mailable 类构造函数声明了必需参数（$username），但实际调用时传入的变量名或值未正确定义或传递。从你的代码可见，OrderShipped 的 __construct() 明确要求一个参数：
public function __construct($username)
{
// $this->username = $user; ← 此行被注释，且变量名不匹配！
}然而在 MailController@test 方法中，你创建实例时写的是：
Mail::to($user->email)->send(new OrderShipped($user)); // ↑↑↑ 传入的是 $user（User 模型实例） // 但构造函数形参叫 $username → 类型不匹配 + 逻辑意图错位
更严重的是，答案中给出的“修复建议”本身存在致命错误：
❌ 错误示范（来自原答案）：
Mail::to($user->email)->send(new OrderShipped($username)); // $username 未定义！PHP Notice: Undefined variable
这会导致运行时 Undefined variable: username，完全不可用。
✅ 正确做法应是 保持参数语义清晰、赋值准确、并在构造函数中完成属性绑定。以下是完整修正步骤：
✅ 1. 明确构造函数意图并正确赋值
假设你想在邮件中使用用户姓名（如 $user->name），推荐将 User 实例传入（更灵活、安全），并在 Mailable 中提取所需字段：
app/Mail/OrderShipped.php
<?php
namespace App\Mail;
use Illuminate\Bus\Queueable;
use Illuminate\Mail\Mailable;
use Illuminate\Queue\SerializesModels;
use App\Models\User;
class OrderShipped extends Mailable
{
use Queueable, SerializesModels;
public User $user; // 类型声明更安全（PHP 7.4+）
public function __construct(User $user)
{
$this->user = $user; // ✅ 正确绑定模型实例
}
public function build()
{
return $this->from('test@example.com', 'Test')
->subject('Password Reset Instructions') // 可选：设置主题
->view('emails.basic'); // 视图中可通过 $user 访问模型
}
}✅ 2. 在控制器中正确传参
app/Http/Controllers/MailController.php
<?php
namespace App\Http\Controllers;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Auth;
use Illuminate\Support\Facades\Mail;
use App\Mail\OrderShipped;
use App\Models\User;
class MailController extends Controller
{
public function test(Request $request)
{
$user = User::findOrFail(Auth::id()); // ✅ 使用 Auth::id() 更简洁；findOrFail 避免 null
Mail::to($user->email)->send(new OrderShipped($user)); // ✅ 传入 $user 实例
return response()->json(['message' => 'Email sent successfully']);
}
}✅ 3. 在邮件视图中使用数据
resources/views/emails/basic.blade.php
<h2>Hello, {{ $user->name }}!</h2>
<p>Your email is: {{ $user->email }}</p>
<p>Thank you for using our service.</p>⚠️ 注意事项
- 不要注释掉构造函数赋值逻辑：$this->user = $user; 是必须的，否则视图无法访问 $user。
- 避免使用未定义变量（如 $username）：Laravel 不会自动将模型属性映射为同名变量，必须显式赋值。
- 类型提示增强健壮性：public function __construct(User $user) 可让 IDE 和 PHP 自动校验传参类型。
- Laravel 9 默认启用队列？ 若启用队列，请确保 OrderShipped 实现 ShouldQueue 并配置好队列驱动，否则可能静默失败。
✅ 总结
Too few arguments 错误本质是 PHP 函数调用签名不匹配。修复关键有三：
- 构造函数形参名与实参变量名逻辑一致（推荐传 User $user 而非模糊的 $username）；
- 在 __construct() 中完成 $this->property = $param 赋值；
- 控制器调用时确保变量已定义且类型正确。
遵循以上规范，即可彻底解决该错误，并构建出可维护、易扩展的邮件发送逻辑。
