iOS Swift使用EventKit获取本地日历事件为空的问题排查

核心问题1：缺失权限请求逻辑 #

EventKit访问系统日历必须先向用户申请授权，你的代码直接创建EKEventStore并尝试读取日历，此时未完成权限校验，后续操作无法获取到有效数据。

核心问题2：日期范围设置错误 #

你定义的oneMonthAgo是当前时间Date()，这意味着只会获取当前时刻到未来一个月的事件，若本地保存的事件在当前时间之前，自然不会被纳入查询范围。

修复后的完整代码 #

import EventKit

// 复用全局EKEventStore实例，避免重复创建带来的权限检查开销
let eventStore = EKEventStore()

func fetchEvents() {
    // 先校验并申请日历权限
    let authStatus = EKEventStore.authorizationStatus(for: .event)
    
    switch authStatus {
    case .authorized:
        // 已授权，执行事件读取逻辑
        loadCalendarEvents()
    case .denied, .restricted:
        print("请前往系统设置，允许应用访问日历权限")
    case .notDetermined:
        // 首次请求权限
        eventStore.requestAccess(to: .event) { [weak self] granted, error in
            if granted {
                DispatchQueue.main.async {
                    self?.loadCalendarEvents()
                }
            } else {
                print("用户拒绝了日历权限申请")
            }
        }
    @unknown default:
        print("未知的权限状态")
    }
}

private func loadCalendarEvents() {
    let calendars = eventStore.calendars(for: .event)
    
    // 修正日期范围：覆盖过去一个月到未来一个月的事件
    let oneMonthAgo = Date(timeIntervalSinceNow: -30 * 24 * 3600)
    let oneMonthAfter = Date(timeIntervalSinceNow: 30 * 24 * 3600)
    
    for calendar in calendars {
        let predicate = eventStore.predicateForEvents(
            withStart: oneMonthAgo,
            end: oneMonthAfter,
            calendars: [calendar]
        )
        
        let events = eventStore.events(matching: predicate)
        
        for event in events {
            titles.append(event.title)
            startDates.append(event.startDate)
            endDates.append(event.endDate)
        }
    }
}

必要的项目配置 #

1. Info.plist添加权限描述：必须在Info.plist中添加以下权限说明（iOS 17+需额外添加全权限描述）：
   • NSCalendarsUsageDescription：填写应用访问日历的原因，例如"需要读取日历事件以展示您的日程安排"
   • NSCalendarsFullAccessUsageDescription：iOS 17及以上版本必填，用于申请全权限访问日历

额外排查点 #

• 确认本地日历的事件时间确实在oneMonthAgo到oneMonthAfter范围内
• 检查设备「设置-隐私与安全性-日历」中，你的应用是否已被授予权限
• 若使用模拟器，确保模拟器日历中已添加对应时间范围内的测试事件

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