You need to enable JavaScript to run this app. SwiftUI获取JSON数组首项时触发索引越界致命错误的解决
优惠活动
大模型
产品
解决方案
定价
更多

SwiftUI获取JSON数组首项时触发索引越界致命错误的解决

崩溃原因与核心解决思路

你遇到的索引越界,是因为results数组初始化时为空,直接通过[0]下标访问首个元素时,数组长度为0、没有对应索引值,直接触发了运行时崩溃。要彻底解决这个问题,只需要做到两点:

  • 用Swift数组内置的first属性安全获取首个元素(该属性为可选类型,数组为空时返回nil,不会触发崩溃)
  • 给图片组件搭配内置占位逻辑,在URL为空、图片未加载完成时展示占位内容
具体代码修正

1. 视图层(HomeView)修正

替换原有的下标取值写法,用可选链串联整个取值流程,同时配置占位图,修正遗漏的状态绑定与请求触发逻辑:

struct HomeView: View {
    @EnvironmentObject var searchObjectController: SearchObjectController

    var body: some View {
        NavigationView {
            VStack {
                HStack { }
                NavigationLink(destination: CameraView()) {
                    Label("Snap", systemImage: "camera")
                        .foregroundColor(Color.purple)
                        .padding(20)
                        .border(Color.purple, width: 2)
                }

                // 修正:绑定控制器内的searchText,原写法直接引用未定义的searchText会触发编译错误
                Text("topic for today: \(searchObjectController.searchText)")
                    .fontWeight(.bold)
                    .padding(6)

                NavigationLink(destination: GenerateView()) {
                    // 安全取值:通过可选链串联整个流程,不会触发越界
                    // results.first 安全取数组首元素,为nil时自动走占位逻辑
                    // flatMap 处理URL可失败初始化的情况,避免嵌套可选
                    WebImage(
                        url: searchObjectController.results.first?.urls.small.flatMap { URL(string: $0) }
                    )
                    // 配置占位图:URL为空、图片加载过程中自动展示
                    .placeholder {
                        Image(systemName: "photo.on.rectangle")
                            .resizable()
                            .scaledToFit()
                            .foregroundColor(.gray)
                            .frame(height: 100)
                    }
                    .resizable()
                    .scaledToFill()
                    .frame(height: 100, alignment: .center)
                    .clipped()
                    .cornerRadius(10)
                    .overlay(ImageOverlay(), alignment: .topLeading)
                }

                Spacer()
            }
            .navigationBarTitle("DrawDaily")
            // 触发搜索请求:页面出现时自动拉取图片数据,原写法没有调用方法会导致results永远为空
            .onAppear {
                searchObjectController.search()
            }
        }
    }
}

2. 控制器层(SearchObjectController)优化

修正原有的URL拼接逻辑、重复追加数据的问题,保证请求可正常返回正确结果:

class SearchObjectController : ObservableObject {
    var token = "gQR-YsX0OpwkYpbjhPVi3b4kSR-DtWrR5phwDm2kPMM"
    @Published var results = [Result]()
    @Published var searchText : String = "whales"

    func search () {
        // 发起新搜索前清空旧数据,避免结果无限堆积
        results.removeAll()
        
        // 用URLComponents构造合法请求,自动处理查询参数的特殊字符编码,避免请求失效
        var components = URLComponents(string: "https://api.unsplash.com/search/photos")
        components?.queryItems = [
            URLQueryItem(name: "query", value: searchText)
        ]
        guard let url = components?.url else { return }
        
        var request = URLRequest(url: url)
        request.httpMethod = "GET"
        request.setValue("Client-ID \(token)", forHTTPHeaderField: "Authorization")
        
        let task = URLSession.shared.dataTask(with: request) { (data, response, error) in
            guard let data = data else { return }
            do {
                let res = try JSONDecoder().decode(Results.self, from: data)
                DispatchQueue.main.async {
                    self.results.append(contentsOf: res.results)
                }
            } catch {
                print("图片数据解析失败: \(error)")
            }
        }
        task.resume()
    } 
}
关键逻辑说明
  • 可选链results.first?.urls.small.flatMap { URL(string: $0) }的执行逻辑:
    • 数组为空时:results.first返回nil,整个表达式直接返回nil,WebImage收到空URL后自动展示配置的占位图
    • 数组有值时:正常取出首元素的small图地址,初始化URL后传给WebImage加载真实图片
  • 完全不需要手动判断数组是否非空,所有分支都由可选链自动处理,从根源上避免下标越界的崩溃

内容的提问来源于stack exchange,提问作者SpikeThea

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.24 21:36:02