SwiftUI中使用JSON解码数据时持续返回nil的问题解决方法

• 同步网络请求阻塞主线程 + API拦截：Data(contentsOf: url) 是同步方法，在onAppear的主线程执行时会直接卡死UI，且Reddit API默认拦截无自定义User-Agent的请求，大概率返回403错误，你之前测试的“成功解码”可能是其他场景下的结果，实际运行时请求直接失败，走到了return getNilUser()分支。
• 视图渲染时机错位：onAppear是在视图首次渲染完成后才触发的，首次渲染时theUser还是初始的空值，就算后续赋值，若请求失败根本没拿到有效值，就会一直显示默认空值。
• getUser逻辑缺陷：不管请求成功失败，函数最后都会走到return getNilUser()，只有嵌套do块里解码成功时才会返回有效值，中间任何一步抛错都会直接返回空对象。
• 回调绑定位置错误：你把onAppear绑定在第二个Text上，如果该Text未正常渲染（比如被父视图隐藏），onAppear根本不会执行，赋值逻辑永远不会触发。

• 在所有catch块里补充详细错误打印，添加print(error.localizedDescription)，如果看到403错误即可确认是请求头被拦截。
• 在onAppear的赋值语句后添加print(theUser)，确认实际拿到的是有效值还是空对象。
• 把onAppear移到父视图上，避免子视图未渲染导致回调不触发。

struct ContentView: View {
    // 用布尔值标记是否已发起过请求，避免重复调用
    @State private var hasFetchedUser = false
    // 直接用可选类型，替代原来的getNilUser()空对象逻辑
    @State private var theUser: User?
    
    var body: some View {
        VStack(spacing: 16) {
            Text("User Profile")
            // 用可选链取值，避免层级属性为nil时崩溃
            Text(theUser?.data?.subreddit?.display_name_prefixed ?? "No name found")
        }
        // 绑定在父视图上，确保一定会触发回调
        .onAppear {
            guard !hasFetchedUser else { return }
            hasFetchedUser = true
            getUser(username: "markregg")
        }
    }
    
    // 改为异步网络请求，避免阻塞主线程
    private func getUser(username: String) {
        guard let url = URL(string: "https://www.reddit.com/user/\(username)/about.json") else {
            print("无效的请求URL")
            return
        }
        var request = URLRequest(url: url)
        // 必须添加User-Agent请求头，否则会被Reddit API拦截返回403
        request.setValue("SwiftUI Test App", forHTTPHeaderField: "User-Agent")
        
        URLSession.shared.dataTask(with: request) { data, response, error in
            // 回到主线程更新@State，否则不会触发视图重渲染
            DispatchQueue.main.async {
                if let error = error {
                    print("请求错误：\(error.localizedDescription)")
                    return
                }
                guard let data = data else {
                    print("未获取到有效数据")
                    return
                }
                do {
                    let decodedUser = try JSONDecoder().decode(User.self, from: data)
                    self.theUser = decodedUser
                } catch {
                    print("解码错误：\(error.localizedDescription)")
                }
            }
        }.resume()
    }
}

// 模型命名改为大写开头，符合Swift规范，所有可能为nil的属性标记为可选
struct User: Codable {
    let data: UserData?
}
struct UserData: Codable {
    let subreddit: Subreddit?
}
struct Subreddit: Codable {
    let display_name_prefixed: String?
}

• 用URLSession的异步数据请求替代Data(contentsOf:)，不会阻塞主线程，系统网络栈可正常处理请求。
• 添加User-Agent请求头，解决Reddit API的拦截问题。
• 所有和@State相关的UI更新都放到主线程的DispatchQueue.main.async中，确保SwiftUI能正常触发视图重渲染。
• 用可选链替代原来的强制取值，避免某个层级属性为nil时直接崩溃。
• 移除了getNilUser()的空对象逻辑，直接用可选类型更直观，减少不必要的对象创建。

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