Swift 4：JSONDecoder在特定场景解码失败——提示‘操作无法完成’

Hey there! That generic error message is super frustrating—let’s break down how to get to the root of the problem and fix your decoding failure. Here’s a step-by-step approach to diagnose and resolve the issue:

1. Capture the Full, Specific Error Details #

The "operation could not be completed" message is just a generic wrapper for a more detailed decoding error. You need to expand your catch block to print the full error context, which will tell you exactly what’s wrong. Update your code like this:

import Foundation

let jsonTextContainingArrayOfInt: String = "[1,2,3]"
guard let data = jsonTextContainingArrayOfInt.data(using: .utf8) else {
    print("Failed to convert string to data!")
    exit(1)
}

do {
    let arrayOfInt: [Int] = try JSONDecoder().decode([Int].self, from: data)
    for n in arrayOfInt {
        print(n)
    }
} catch {
    print("=== Full Error Details ===")
    print(error)
    print("\nLocalized Description: \(error.localizedDescription)")
    
    // Dig into DecodingError specifics for nested/type issues
    if let decodingError = error as? DecodingError {
        print("\n=== Decoding Error Breakdown ===")
        switch decodingError {
        case .keyNotFound(let key, let context):
            print("Missing required key: '\(key.stringValue)' at coding path: \(context.codingPath)")
        case .typeMismatch(let expectedType, let context):
            print("Type mismatch: Expected \(expectedType) but got wrong type at path: \(context.codingPath)")
        case .valueNotFound(let expectedType, let context):
            print("Value missing: Expected \(expectedType) but got null/missing value at path: \(context.codingPath)")
        case .dataCorrupted(let context):
            print("Corrupted JSON data at path: \(context.codingPath)")
        default:
            print("Unknown decoding error occurred")
        }
    }
}

This will reveal the actual problem—like a missing key, type mismatch (e.g., JSON has a string where your model expects an Int), or malformed JSON.

2. Validate Your Input JSON #

Sometimes the issue is with the JSON itself, not your code. First, print the raw JSON string you’re trying to decode to make sure it’s what you expect:

if let rawJson = String(data: data, encoding: .utf8) {
    print("Raw JSON being decoded: \(rawJson)")
}

Check for common JSON syntax errors: unclosed quotes, trailing commas, mismatched brackets, or invalid escape characters. You can use a local JSON validator tool (a basic offline checker or Xcode’s built-in syntax highlighting works great) to confirm the JSON is valid.

3. Audit Your Codable Model (If Using Custom Types) #

If you’re decoding a custom Codable struct/class (not just a simple array), double-check these common mismatches:

• Type alignment: Ensure every property in your model matches the type in the JSON (e.g., if JSON has "age": "25", your model can’t use Int age—it needs String age or a custom decoder to handle the conversion).
• Coding keys: If your model’s property names don’t exactly match the JSON keys, make sure you’ve defined a CodingKeys enum to map them correctly. For example:

  struct User: Codable {
      let userName: String
      
      enum CodingKeys: String, CodingKey {
          case userName = "user_name" // Maps JSON's "user_name" to model's userName
      }
  }
  

• Optional properties: If a JSON field might be missing or null, mark the corresponding model property as optional (e.g., var bio: String? instead of var bio: String).
• Nested structures: Ensure any nested Codable types are properly implemented and their properties align with the JSON’s nested structure.

4. Check for Edge Cases #

• Empty data: Make sure your data isn’t empty before attempting to decode. The guard let statement in the code above helps with this.
• Special number formats: If the JSON uses scientific notation (e.g., "value": 1e3) or large numbers that exceed Int limits, you might need to use Double or Int64 in your model.
• Whitespace or hidden characters: Sometimes JSON strings contain invisible whitespace or control characters—trim your input string before converting to data if needed:

  let cleanedJsonText = jsonTextContainingArrayOfInt.trimmingCharacters(in: .whitespacesAndNewlines)
  guard let data = cleanedJsonText.data(using: .utf8) else { ... }
  

Once you have the specific error from step 1, you’ll be able to target the exact issue and fix it quickly!

内容的提问来源于stack exchange，提问作者User Not Found