如何创建可被Outlook正常兼容的ics日历订阅文件

修复方案 #

一、响应头配置调整 #

• 移除content-disposition: attachment配置：Outlook对附件形式返回的日历订阅识别不稳定，直接删除这个响应头即可，不需要指定为附件下载。
• 修正content-type配置：把method=REQUEST删掉，订阅用的公共日历不需要REQUEST方法，改成content-type: text/calendar; charset=utf-8即可，冗余的name参数也可以直接删除，避免触发Outlook的校验异常。
• 新增缓存控制相关响应头：

  Cache-Control: public, max-age=900
  ETag: "当前ics文件内容的唯一哈希值"
  Last-Modified: ics内容最后变更的时间，需符合HTTP标准日期格式
  

  这几个头是Outlook判断内容是否需要更新的核心依据，缺失的话outlook.com会直接不触发更新逻辑。
• 新增X-Published-Calendar-TTL响应头：值设为900（单位为秒，可根据你的实际更新频率调整），这是微软系客户端专门识别的日历更新间隔配置，可直接解决订阅不更新的问题。

二、ICS文件内部字段补充 #

• 在VCALENDAR节点下新增X-WR-CALNAME字段，指定日历的固定名称，不要每次生成文件时动态变更。
• 新增X-WR-RELCALID字段，给日历分配一个全局唯一的固定ID，Outlook重启后靠这个ID识别已订阅的日历，缺失的话就会出现重启后日历消失的问题。
• 每个VEVENT的UID必须固定，对应事件内容变更时不要修改UID，Outlook靠UID匹配更新事件。

三、订阅协议适配 #

• 同时提供webcal://和https://两种订阅链接，部分版本的桌面Outlook对webcal协议的缓存处理存在bug，用https协议订阅的稳定性更高。
• 服务端要支持HEAD请求，Outlook在更新前会先发送HEAD请求校验资源是否存在，如果返回405等错误就会直接把订阅标记为失效。

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