Laravel Mailable发ICS文件后Outlook无RSVP按钮且无法解析问题

问题详情 #

我通过Laravel Mailable发送ICS会议邀请，Gmail可正常解析并显示RSVP按钮，但Outlook无法识别该ICS文件，也不显示对应的接受/拒绝/暂定按钮。奇怪的是，直接下载该ICS文件并通过Gmail发送给Outlook，却能正常显示RSVP按钮。

我的ICS文件内容 #

BEGIN:VCALENDAR
METHOD:REQUEST
PRODID:-//Bookmytime.AI//BOOKMYTIME//EN
VERSION:2.0
CALSCALE:GREGORIAN
BEGIN:VEVENT
UID:054ea174cce27588ef8c432603e684c5@bookmytime.ai
DTSTAMP:20240131T093000Z
DTSTART:20240131T093000Z
DTEND:20240131T103000Z
ORGANIZER;CN=jigar halani:mailto:jigar@storat.com
ATTENDEE;CUTYPE=INDIVIDUAL;ROLE=REQ-PARTICIPANT;PARTSTAT=NEEDS-ACTION;
RSVP=TRUE;mailto:my@outlook.com
DESCRIPTION:Hello be prepared and ready for interview
LOCATION:Delhi
SUMMARY:Interview with test
END:VEVENT
END:VCALENDAR

Laravel中附加ICS的代码 #

$markdown->attach($link->formatWith(new \App\Modules\Miscellaneous\Services\BookmytimeICS($options)), ['as' => 'meeting.ics', 'mime' => 'text/calendar'])

解决方法 #

1. 修正ICS附件的MIME类型参数 #

Outlook要求ICS附件的MIME类型必须包含method=REQUEST参数，否则无法识别为会议邀请请求。将attach改为attachData并更新MIME设置：

$icsContent = $link->formatWith(new \App\Modules\Miscellaneous\Services\BookmytimeICS($options));
$markdown->attachData($icsContent, 'meeting.ics', [
    'mime' => 'text/calendar; charset=utf-8; method=REQUEST',
]);

2. 修复ICS字段的换行格式 #

ICS标准中，多行属性必须在换行后添加空格缩进。你的ATTENDEE字段换行后缺少空格，导致Outlook解析失败。修改为：

ATTENDEE;CUTYPE=INDIVIDUAL;ROLE=REQ-PARTICIPANT;PARTSTAT=NEEDS-ACTION;
 RSVP=TRUE:mailto:my@outlook.com

或者直接将属性写在同一行：

ATTENDEE;CUTYPE=INDIVIDUAL;ROLE=REQ-PARTICIPANT;PARTSTAT=NEEDS-ACTION;RSVP=TRUE:mailto:my@outlook.com

3. 使用标准iCalendar库生成ICS #

手动拼接ICS容易出现格式疏漏，建议使用spatie/icalendar-generator这类符合RFC标准的库生成ICS文件：

首先安装库：

composer require spatie/icalendar-generator

然后替换ICS生成逻辑：

use Spatie\IcalendarGenerator\Components\Calendar;
use Spatie\IcalendarGenerator\Components\Event;
use Carbon\Carbon;

$event = Event::create()
    ->name('Interview with test')
    ->description('Hello be prepared and ready for interview')
    ->startsAt(Carbon::parse('2024-01-31 09:30:00')->utc())
    ->endsAt(Carbon::parse('2024-01-31 10:30:00')->utc())
    ->location('Delhi')
    ->organizer('jigar@storat.com', 'jigar halani')
    ->attendee('my@outlook.com', null, true); // 开启RSVP要求

$calendar = Calendar::create('Bookmytime.AI')
    ->event($event)
    ->method('REQUEST');

$icsContent = $calendar->get();

$markdown->attachData($icsContent, 'meeting.ics', [
    'mime' => 'text/calendar; charset=utf-8; method=REQUEST',
]);

4. 调整邮件的MIME结构 #

Outlook对邮件的MIME结构敏感，尝试强制设置为multipart/mixed类型：

$this->withSwiftMessage(function ($message) {
    $message->getHeaders()->addTextHeader(
        'Content-Type',
        'multipart/mixed; boundary="'.uniqid().'"'
    );
});

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