Swift 4 JSON解析失败：无需Facebook API获取脸书页面活动

Hey there! Let's troubleshoot your Swift 4 JSON parsing issue for Facebook page events (no API required). I’ll walk through the most common pitfalls and fixes based on typical scenarios with this kind of data.

First, let’s start by aligning on the JSON structure you’re working with (using your single-event example):

{
  "data": [
    {
      "id": "123456789",
      "name": "Sample Community Meetup",
      "start_time": "2024-06-15T18:30:00+0100",
      "end_time": "2024-06-15T21:00:00+0100",
      "location": "Downtown Co-working Space",
      "description": "Join us for networking and project demos!"
    }
  ],
  "paging": {
    "next": "https://example.com/next-page"
  }
}

Common Parsing Issues & Fixes #

1. Mismatched Key Naming (Snake Case vs. Camel Case)

Facebook uses snake_case for JSON keys (like start_time), but Swift conventions use camelCase (startTime). If your struct doesn’t account for this, decoding will fail silently or throw a key-not-found error.

Fix Option 1: Use CodingKeys Explicitly

struct FacebookEvent: Codable {
    let id: String
    let name: String
    let startTime: String
    let endTime: String
    let location: String?
    let description: String?

    // Map snake_case keys to camelCase properties
    enum CodingKeys: String, CodingKey {
        case id, name, location, description
        case startTime = "start_time"
        case endTime = "end_time"
    }
}

// Top-level struct to match the JSON root
struct EventResponse: Codable {
    let data: [FacebookEvent]
    let paging: Paging?
}

struct Paging: Codable {
    let next: String?
}

Fix Option 2: Auto-Convert with JSONDecoder
Skip manual CodingKeys by setting the decoder’s key decoding strategy:

let decoder = JSONDecoder()
decoder.keyDecodingStrategy = .convertFromSnakeCase

2. Unhandled Optional Fields

Some Facebook event fields (like location or description) might be null in the JSON. If your struct defines these as non-optional types, decoding will fail.

Fix: Mark all potentially nullable fields with ?:

struct FacebookEvent: Codable {
    let id: String
    let name: String
    let startTime: String
    let endTime: String
    let location: String? // Marked as optional
    let description: String? // Marked as optional
}

3. Date Format Mismatch

Facebook’s timestamp format (yyyy-MM-dd'T'HH:mm:ssZ) isn’t supported by Swift’s default JSONDecoder date strategy. Trying to decode start_time directly into a Date type will throw an error.

Fix: Use a custom date formatter:

// Create a formatter matching Facebook's timestamp format
let dateFormatter = DateFormatter()
dateFormatter.dateFormat = "yyyy-MM-dd'T'HH:mm:ssZ"
dateFormatter.locale = Locale(identifier: "en_US_POSIX") // Critical for consistent parsing

// Configure the decoder
let decoder = JSONDecoder()
decoder.keyDecodingStrategy = .convertFromSnakeCase
decoder.dateDecodingStrategy = .formatted(dateFormatter)

// Update your struct to use Date instead of String
struct FacebookEvent: Codable {
    let id: String
    let name: String
    let startTime: Date
    let endTime: Date
    let location: String?
    let description: String?
}

4. Ignoring the Top-Level JSON Structure

You can’t directly decode the data array—you need a top-level struct (like EventResponse) to match the root JSON object that wraps the data array.

Wrong:

// This will fail because the JSON root is an object, not an array
let events = try decoder.decode([FacebookEvent].self, from: data)

Correct:

let response = try decoder.decode(EventResponse.self, from: data)
let events = response.data // Access the array from the top-level object

5. Debugging with Detailed Error Messages

Always wrap decoding in a do-catch block and print specific errors to pinpoint issues:

func fetchAndParseEvents() {
    guard let url = URL(string: "your-facebook-events-url") else {
        print("Invalid URL")
        return
    }

    URLSession.shared.dataTask(with: url) { data, _, error in
        guard let data = data, error == nil else {
            print("Fetch error: \(error?.localizedDescription ?? "Unknown error")")
            return
        }

        do {
            let decoder = JSONDecoder()
            decoder.keyDecodingStrategy = .convertFromSnakeCase
            
            let dateFormatter = DateFormatter()
            dateFormatter.dateFormat = "yyyy-MM-dd'T'HH:mm:ssZ"
            dateFormatter.locale = Locale(identifier: "en_US_POSIX")
            decoder.dateDecodingStrategy = .formatted(dateFormatter)

            let response = try decoder.decode(EventResponse.self, from: data)
            print("Success! Parsed \(response.data.count) events")
            // Process your events here
        } catch {
            print("Decoding failed: \(error)")
            // Dig into specific error types
            if let decodingError = error as? DecodingError {
                switch decodingError {
                case .keyNotFound(let key, let context):
                    print("Missing key: \(key.stringValue) | Context: \(context.debugDescription)")
                case .typeMismatch(let type, let context):
                    print("Type mismatch for \(type) | Context: \(context.debugDescription)")
                default:
                    print("Other decoding error: \(decodingError)")
                }
            }
        }
    }.resume()
}

Try these fixes step by step—start with printing detailed decoding errors first, as that will tell you exactly where the parsing is breaking down.

内容的提问来源于stack exchange，提问作者V. Guichard