iOS Universal Link可正常打开App，但无法将user_id存入UserDefaults

我在iOS应用中使用Universal Link，链接能正常唤起App，但URL中的user_id参数始终无法存入UserDefaults。测试链接格式为https://example.com/open?user_id=a4a64be8-9a74-4960-8f0b-80aee292614f，已确认URL结构合法、user_id参数存在，但后续调用UserDefaults.standard.string(forKey: "user_id")始终返回nil。

以下是我的代码实现：

AppDelegate.swift #

import UIKit

class AppDelegate: UIResponder, UIApplicationDelegate {
    func application(_ application: UIApplication, continue userActivity: NSUserActivity, restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {
        guard userActivity.activityType == NSUserActivityTypeBrowsingWeb,
              let incomingURL = userActivity.webpageURL else {
            return false
        }

        // 检测路径中的"open"并获取user_id参数
        if incomingURL.pathComponents.contains("open"),
           let userID = incomingURL.queryParameters?["user_id"] {
            
            // 尝试将userID存入UserDefaults
            UserDefaults.standard.set(userID, forKey: "user_id")
            return true
        }

        return false
    }
}

URLExtensions.swift #

import Foundation

extension URL {
    var queryParameters: [String: String]? {
        var params = [String: String]()
        let queryItems = URLComponents(url: self, resolvingAgainstBaseURL: false)?.queryItems
        queryItems?.forEach {
            params[$0.name] = $0.value
        }
        return params
    }
}

读取user_id的SwiftUI视图代码 #

import SwiftUI

struct ContentView: View {
    @State private var userId: String = ""  // 用于展示user_id的State变量

    var body: some View {
        VStack {
            Text("User ID: \(userId.isEmpty ? "Not Available" : userId)")
                .foregroundColor(.white)
                .padding()

            Button("Check User ID") {
                // 测试用：手动获取并展示UserDefaults中的值
                userId = getUserId()
                print("Fetched User ID:", userId)
            }
        }
        .onAppear {
            // 视图出现时获取user_id
            userId = getUserId()
            print("User ID on appear:", userId)
        }
        .background(Color.gray)
    }

    func getUserId() -> String {
        // 从UserDefaults读取user_id
        return UserDefaults.standard.string(forKey: "user_id") ?? ""
    }
}

问题排查与修复方案 #

1. 核心逻辑分支未触发 #

先在UserDefaults保存代码前添加日志，确认是否进入了参数解析的分支：

if incomingURL.pathComponents.contains("open"),
   let userID = incomingURL.queryParameters?["user_id"] {
    print("已捕获user_id：\(userID)") // 添加此行日志
    UserDefaults.standard.set(userID, forKey: "user_id")
    UserDefaults.standard.synchronize() // 强制同步写入磁盘
    return true
}

UserDefaults默认异步写入，手动调用synchronize()可确保值立即持久化，避免因App快速切换导致写入丢失。

2. URL参数解析失败 #

URLComponents可能因URL编码问题解析失败，替换成手动解析query的扩展：

extension URL {
    var queryParameters: [String: String]? {
        guard let query = self.query else { return nil }
        var params = [String: String]()
        let pairs = query.components(separatedBy: "&")
        for pair in pairs {
            let parts = pair.components(separatedBy: "=")
            guard parts.count == 2, 
                  let key = parts[0].removingPercentEncoding, 
                  let value = parts[1].removingPercentEncoding else { continue }
            params[key] = value
        }
        return params
    }
}

3. SwiftUI生命周期下AppDelegate方法未执行 #

如果你的项目使用iOS 14+的SwiftUI新生命周期，AppDelegate的continueUserActivity方法不会被触发，需在App结构体中处理：

@main
struct YourApp: App {
    var body: some Scene {
        WindowGroup {
            ContentView()
                .onContinueUserActivity(NSUserActivityTypeBrowsingWeb) { userActivity in
                    guard let incomingURL = userActivity.webpageURL else { return }
                    if incomingURL.pathComponents.contains("open"),
                       let userID = incomingURL.queryParameters?["user_id"] {
                        UserDefaults.standard.set(userID, forKey: "user_id")
                        UserDefaults.standard.synchronize()
                        print("已保存user_id：\(userID)")
                    }
                }
        }
    }
}

4. 读取时机过早 #

冷启动时，ContentView的onAppear可能在Universal Link处理逻辑前执行，导致读取到旧值。改用@AppStorage自动监听UserDefaults变化：

struct ContentView: View {
    @AppStorage("user_id") private var userId: String = ""

    var body: some View {
        VStack {
            Text("User ID: \(userId.isEmpty ? "Not Available" : userId)")
                .foregroundColor(.white)
                .padding()

            Button("Check User ID") {
                print("当前User ID：\(userId)")
            }
        }
        .background(Color.gray)
    }
}

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