Laravel 9.36发送会议邀请邮件不被识别问题求助

使用PHP及Laravel 9.36发送会议邀请邮件，将invite.ics作为附件添加，MIME类型设置为'text/calendar; charset=utf-8; method=REQUEST'，但Outlook和Gmail均未将其识别为会议邮件，仅当作带附件的普通邮件。需要调整哪些设置才能让邮件被识别为会议邮件？

现有关键代码 #

附件处理

public function attachments(): array
{
     return [
            Attachment::fromData(function() {
                return $this->createIcs()->get();
            }, 'invite.ics')
            ->withMime('text/calendar; charset=utf-8; method=REQUEST')
     ];
}

邮件头设置

public function headers(): Headers
{
    return new Headers(
        text: [
            'X-FE-Attachment-Name' => 'invite.ics',
        ],
    );
}

ICS文件生成

public function createIcs(): Calendar
{
    $registration = $this->registration;
    $location = $registration->location;

    return Calendar::create()
        ->appendProperty(
            TextProperty::create('CALSCALE', 'GREGORIAN'),
        )
        ->appendProperty(
            TextProperty::create('METHOD', 'REQUEST'),
        )
        ->event(
            Event::create()
                ->name($location->name)
                ->address($location->address)
                ->addressName($location->name)
                ->description('Welcome to the event: ' . $location->name)               
                ->organizer($registration->email, 'Acme Company')
                ->attendee($registration->email, $registration->email, ParticipationStatus::accepted(), requiresResponse: true)
                ->createdAt(now())
                ->startsAt(
                    new DateTime(
                        $location->date->format('d.m.Y') . ' ' . $location->schedule->start_time->format('H:i')
                    )
                )
                ->endsAt(
                    new DateTime(
                        $location->date->format('d.m.Y') . ' ' . $location->schedule->end_time->format('H:i')
                    )
                )
                ->withoutTimezone()
                ->status(EventStatus::confirmed())
                ->appendProperty(TextProperty::create('TRANSP', 'OPAQUE'))
    );
}

生成的ICS内容

BEGIN:VCALENDAR
VERSION:2.0
PRODID:-//Acme Company//EN
CALSCALE:GREGORIAN
METHOD:REQUEST
BEGIN:VEVENT
UID:63721bd7233ec
DTSTAMP:20221114T104335Z
SUMMARY:Event location name
DESCRIPTION:Welcome to the event: event name
LOCATION: event location
CLASS:PRIVATE
STATUS:CONFIRMED
ORGANIZER;CN=My Company Roadshow:MAILTO:example@email.com
ATTENDEE;CN=my@email.com;PARTSTAT=ACCEPTED:MAILTO:my@email.com
DTSTART:20230118T070000
DTEND:20230118T150000
TRANSP:OPAQUE
BEGIN:VALARM
ACTION:DISPLAY
DESCRIPTION:The event is starting tomorrow!
TRIGGER;VALUE=DATE-TIME:20230117T090000
END:VALARM
END:VEVENT
END:VCALENDAR

要让邮件客户端识别为会议邀请，需从MIME结构、ICS内容、邮件头三个维度调整：

1. 将ICS内容作为邮件替代内容发送 #

不要仅把ICS当作附件，需同时将其添加为邮件的text/calendar类型替代内容，这是客户端识别会议邀请的核心逻辑。修改邮件类的build方法：

public function build()
{
    $icsContent = $this->createIcs()->get();

    return $this->view('emails.meeting-invite') // 替换为你的邮件视图文件
        // 保留附件（可选，方便用户手动导入日历）
        ->attachData($icsContent, 'invite.ics', [
            'mime' => 'text/calendar; charset=utf-8; method=REQUEST',
        ])
        ->withSwiftMessage(function ($message) use ($icsContent) {
            // 添加Outlook识别所需的邮件头
            $message->getHeaders()->addTextHeader('Content-Class', 'urn:content-classes:calendarmessage');
            
            // 创建text/calendar类型的邮件部分
            $calendarPart = new \Swift_MimePart($icsContent, 'text/calendar', 'utf-8');
            $calendarPart->getHeaders()->addParameterHeader('method', 'REQUEST');
            
            // 将calendar部分添加到邮件的替代内容中
            if ($message->getChildren()[0] instanceof \Swift_Mime_Multipart) {
                $message->getChildren()[0]->addChild($calendarPart);
            }
        });
}

2. 修正ICS文件的关键参数 #

（1）设置唯一且带域名的UID #

日历客户端依赖UID识别事件，无域名的UID易重复导致被忽略。修改ICS生成代码中的事件UID：

->event(
    Event::create()
        ->uid(uniqid() . '@yourdomain.com') // 替换为你的业务域名
        // 其他原有参数...
)

（2）修正参会者状态 #

当前参会者状态设为ACCEPTED，会让客户端认为这是已确认的通知而非邀请，需改为NEEDS-ACTION：

->attendee(
    $registration->email, 
    $registration->email, 
    ParticipationStatus::needsAction(), // 改为需要用户响应的状态
    requiresResponse: true
)

3. 调整邮件头设置 #

移除无用的X-FE-Attachment-Name，添加必要的日历识别头：

public function headers(): Headers
{
    return new Headers(
        text: [
            'Content-Class' => 'urn:content-classes:calendarmessage',
            'Content-Disposition' => 'inline',
        ],
    );
}

内容的提问来源于stack exchange，提问作者Greg Ostry