Laravel邮件测试失败：未发送预期WelcomeEmail求助

嘿，我一眼就看到问题所在了——你的测试代码根本没有触发邮件发送的逻辑，直接就断言邮件已发送，这肯定会失败呀！

核心错误点 #

你在testWelcomeMail方法里只做了两件事：启用邮件伪造(Mail::fake())，然后直接断言WelcomeEmail已发送，但完全没有调用任何会发送这个邮件的代码。Mail::fake()只是用来拦截和记录邮件发送请求的，你得先让系统“尝试”发送邮件，它才能记录下来让你断言。

一步步修正 #

1. 修复测试代码，先触发邮件发送

首先，你需要在测试中先创建一个测试用户（推荐用Laravel的模型工厂），然后主动发送邮件，再进行断言。修改后的测试代码如下：

class MailTest extends TestCase {
    public function testWelcomeMail() {
        $this->withoutExceptionHandling();
        
        // 用工厂创建一个测试用户（如果没有工厂，也可以手动创建）
        $user = User::factory()->create(['lang' => 'en']);
        
        Mail::fake();

        // 关键步骤：触发邮件发送！这里直接调用Mail::send，或者调用你的业务逻辑方法
        Mail::to($user->email)->send(new WelcomeEmail($user));

        // 断言邮件已发送，还可以验证邮件的细节（比如收件人、携带的数据）
        Mail::assertSent(WelcomeEmail::class, function ($mail) use ($user) {
            return $mail->hasTo($user->email) && $mail->user->id === $user->id;
        });
    }
}

2. 优化邮件类，避免硬编码依赖

你的WelcomeEmail类还有两个小问题：

• 构造函数接收的$data参数完全没用到，属于冗余代码
• 在build方法里硬编码查询User::find(3425)，测试环境里大概率没有这个ID的用户，而且这种写法非常不灵活

建议把用户对象通过构造函数注入，这样测试时可以直接传入测试用户，也更符合依赖注入的原则：

class WelcomeEmail extends Mailable {
    use Queueable, SerializesModels;
    
    public $user; // 直接公开用户对象，视图里可以直接使用

    public function __construct(User $user) {
        $this->user = $user;
    }

    public function build() {
        $address = 'myjourney@asdasd.com';
        $subject = __('email.welcome_to_journey');
        $name = __('email.my_journey');

        // 使用注入的用户对象，不再硬编码查询
        \App::setLocale($this->user->lang);
        $this->user->update(['is_welcome_email_sent' => 1]); // 用update更简洁

        return $this->view('email.user_welcome', ['user' => $this->user])
            ->from($address, $name)
            ->replyTo($address, $name)
            ->subject($subject);
    }
}

为什么原来的测试会报错？ #

错误信息The expected [App\Mail\WelcomeEmail] mailable was not sent本质上是因为：
Mail::fake()启用后，所有邮件发送请求都会被拦截记录，但你的测试里没有任何代码调用Mail::send()或Mail::queue()来发送WelcomeEmail，所以没有任何邮件被记录，断言自然会失败（false is true就是说系统认为邮件没发送，而你断言它发送了）。

额外建议 #

• 测试时尽量用模型工厂创建测试数据，避免依赖真实环境的固定ID数据
• 断言邮件时，可以加上闭包验证邮件的收件人、主题、携带的数据等细节，让测试更严谨

内容的提问来源于stack exchange，提问作者Furkan ozturk