Swift iOS开发：解包可选值遇nil致命错误及解决方法

Hey there, let's break down why you're hitting this Fatal error: Unexpectedly found nil while unwrapping an Optional value crash and fix it step by step.

1. 修正通知注册的顺序 #

Looking at your code, you're calling application.registerForRemoteNotifications() before registering user notification settings. That's backwards—iOS requires you to get user authorization first before requesting remote notification registration. This mismatch can lead to unexpected nil values later (like a missing device token that you might force-unwrap).

Fix the order like this:

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    // First, set up notification types and settings
    let notificationTypes: UIUserNotificationType = [.alert, .badge, .sound]
    let notificationSettings = UIUserNotificationSettings(types: notificationTypes, categories: nil)
    
    // Register user notification settings FIRST
    application.registerUserNotificationSettings(notificationSettings)
    // Then register for remote notifications
    application.registerForRemoteNotifications()
    
    return true
}

2. 适配iOS 10+的新API（避免弃用API带来的潜在问题） #

The UIUserNotification APIs you're using are deprecated as of iOS 10. Using the modern UserNotifications framework not only avoids deprecated code but also reduces edge cases that might cause nil crashes. Here's how to update your code for iOS 10 and above:

First, import the framework:

import UserNotifications

Then, update your registration logic with version checks:

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    if #available(iOS 10.0, *) {
        let center = UNUserNotificationCenter.current()
        center.requestAuthorization(options: [.alert, .badge, .sound]) { granted, error in
            if granted {
                DispatchQueue.main.async {
                    application.registerForRemoteNotifications()
                }
            }
            // Handle error if needed
        }
    } else {
        // Fallback for iOS 9 and below
        let notificationTypes: UIUserNotificationType = [.alert, .badge, .sound]
        let notificationSettings = UIUserNotificationSettings(types: notificationTypes, categories: nil)
        application.registerUserNotificationSettings(notificationSettings)
        application.registerForRemoteNotifications()
    }
    return true
}

3. 安全处理didReceiveRemoteNotification避免nil解包 #

Your crash might also be happening in the didReceiveRemoteNotification method when you force-unwrap values from userInfo. Never use ! to unwrap optional values here—use optional binding or nil coalescing instead.

For example, instead of:

// Dangerous: Force-unwrapping can crash if the key doesn't exist
let message = userInfo["alert"] as! String

Do this:

// Safe: Optional binding checks for nil first
if let alertDict = userInfo["alert"] as? [String: Any], let message = alertDict["body"] as? String {
    print("Notification message: \(message)")
}

// Or use nil coalescing to provide a default value
let badgeCount = userInfo["badge"] as? Int ?? 0

4. 在didRegisterForRemoteNotificationsWithDeviceToken中检查设备令牌是否为nil #

如果你之后会强制解包设备令牌，一定要处理注册失败的情况。实现这个代理方法来捕获错误：

func application(_ application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: Error) {
    print("Remote notification registration failed: \(error.localizedDescription)")
    // 这里不要尝试使用设备令牌——它会是nil
}

在didRegisterForRemoteNotificationsWithDeviceToken中处理设备令牌时，始终使用可选值安全处理：

func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
    // 安全地将令牌转换为字符串
    let tokenString = deviceToken.map { String(format: "%02.2hhx", $0) }.joined()
    print("Device token: \(tokenString)")
    // 将令牌发送到服务器时，避免强制解包任何值
}

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