Dart

FormatException: Unexpected character (at character 1) <!DOCTYPE html> – Flutter FORMAT_EXCEPTION_JSON

FORMAT_EXCEPTION_JSON

L'errore si verifica durante jsonDecode() quando l'endpoint API ha restituito una pagina di errore HTML (come un 404 o 500) anziché una stringa JSON valida.

Categoria: FlutterGruppo: DartConfidenza: altaUltimo aggiornamento: 19-08-2026Letto 18 volte

Cosa significa questo errore?

L'errore si verifica durante jsonDecode() quando l'endpoint API ha restituito una pagina di errore HTML (come un 404 o 500) anziché una stringa JSON valida.

Messaggio originale

FormatException: Unexpected character (at character 1) <!DOCTYPE html>

Contesto e parole chiave

Alias

  • FormatException JSON Dart

Messaggi alternativi

  • Errore parsing JSON HTML

Prodotti

  • Flutter Framework / Dart SDK / Android Toolchain

Piattaforme

  • Android
  • iOS
  • Linux
  • macOS
  • Windows

Parole chiave

  • Dart
  • errore-dart-format-exception-json
  • flutter.dart.format-exception-invalid-json-utf8

Cause possibili

Causa principale per Errore Dart: FormatException: Unexpected character (Parsing HTML come JSON)

L'errore si verifica durante jsonDecode() quando l'endpoint API ha restituito una pagina di errore HTML (come un 404 o 500) anziché una stringa JSON valida.

molto comune

Diagnosi

Diagnostica dell'ambiente per Errore Dart: FormatException: Unexpected character (Parsing HTML come JSON)

Eseguire il comando di diagnosi Flutter Doctor.

Come leggere il risultato. Restituisce lo stato dell'SDK e delle toolchain native.

flutter
flutter doctor -v

Risoluzione

Risoluzione standard per Errore Dart: FormatException: Unexpected character (Parsing HTML come JSON)

Difficoltà: facileRischio: basso

Esegui i passaggi di ripristino consigliati per sanare la build.

  1. Verificare le configurazioni in pubspec.yaml o build.gradle
  2. Eseguire flutter clean
  3. Rieseguire flutter run
flutter
flutter clean && flutter pub get

Domande frequenti

Come risolvere rapidamente Errore Dart: FormatException: Unexpected character (Parsing HTML come JSON)?

L'errore si verifica durante jsonDecode() quando l'endpoint API ha restituito una pagina di errore HTML (come un 404 o 500) anziché una stringa JSON valida.

Approfondimenti

Schede correlate