ENRU

Незакрытая строка в JSON: «Unterminated string in JSON at position N»

Обновлено

Перевод: «незакрытая строка в JSON, позиция N». Строка без конца. Не в мою смену. Строка JSON тянется от одной прямой двойной кавычки до следующей неэкранированной; если ввод кончается раньше, парсер прочитал как текст всё после открывающей кавычки, и закрыть строку ему нечем.

Ошибка и исправление

Самая частая незакрытая строка совсем не выглядит незакрытой. Путь Windows с обратным слэшем в конце:

{"path": "C:\temp\"}

В JSON обратный слэш начинает escape-последовательность, и \" — это экранированная кавычка, то есть символ кавычки внутри строки. Строка там не кончается: она проглатывает "} и упирается в конец ввода. Каждый обратный слэш в пути нужно удвоить:

{"path": "C:\\temp\\"}

В сломанной версии прячется вторая проблема: \t — допустимый escape для таба, поэтому даже с закрывающей кавычкой "C:\temp" молча означает «C:» + таб + «emp». Валидный JSON, неверные данные.

Почему парсер не находит конец строки

RFC 8259, раздел 7: «A string begins and ends with quotation marks» — строка начинается и заканчивается кавычкой. Внутри нужно экранировать кавычку, обратный слэш и управляющие символы, и \" — как раз способ поместить кавычку в строку. Парсер читает символы, пока не встретит неэкранированную кавычку. Больше строку ничто не закончит: ни перевод строки, ни скобка, ни конец строки в файле.

Сообщения о незакрытой строке в разных парсерах

Строка, оборванная в конце, {"a": "b, и путь из примера выше, {"path": "C:\temp\"}. На открывающую кавычку указывают только Python и валидатор этого сайта, остальные сообщают о конце ввода.

ПарсерОбрыв: {"a": "bСлэш в конце: {"path": "C:\temp\"}
Chrome, Edge, Node.js (V8)Unterminated string in JSON at position 8 (line 1 column 9) Перевод: «незакрытая строка в JSON, позиция 8».Unterminated string in JSON at position 20 (line 1 column 21) Перевод: «незакрытая строка в JSON, позиция 20».
Node.js 18, старый Chrome (V8 10.2)Unexpected end of JSON input Перевод: «неожиданный конец ввода JSON».Unexpected end of JSON input Перевод: то же.
FirefoxJSON.parse: unterminated string at line 1 column 9 of the JSON data Перевод: «незакрытая строка».JSON.parse: unterminated string at line 1 column 21 of the JSON data Перевод: то же.
SafariJSON Parse error: Unterminated string Перевод: «незакрытая строка».JSON Parse error: Unterminated string Перевод: то же.
PythonUnterminated string starting at: line 1 column 7 (char 6) Перевод: «незакрытая строка, начинается в строке 1, колонке 7».Unterminated string starting at: line 1 column 10 (char 9) Перевод: то же, колонка 10.
Go (encoding/json)unexpected end of JSON input Перевод: «неожиданный конец ввода JSON».unexpected end of JSON input Перевод: то же.
Java (Jackson 2)Unexpected end-of-input: was expecting closing quote for a string value Перевод: «неожиданный конец ввода, ожидалась закрывающая кавычка строки».Unexpected end-of-input: was expecting closing quote for a string value Перевод: то же.
C# (System.Text.Json)Expected end of string, but instead reached end of data. Перевод: «ожидался конец строки, а данные кончились».Expected end of string, but instead reached end of data. Перевод: то же.
C# (Newtonsoft.Json)Unterminated string. Expected delimiter: ". Path 'a', line 1, position 8. Перевод: «незакрытая строка, ожидался разделитель "».Unterminated string. Expected delimiter: ". Path 'path', line 1, position 20. Перевод: то же.
PHP (json_decode)Control character error, possibly incorrectly encoded, json_last_error() 3. Перевод: «ошибка управляющего символа, возможно, неверная кодировка».Control character error, possibly incorrectly encoded, json_last_error() 3. Перевод: то же.
Rust (serde_json)EOF while parsing a string at line 1 column 8 Перевод: «конец ввода при разборе строки».EOF while parsing a string at line 1 column 20 Перевод: то же.
jqjq: parse error: Unfinished string at EOF at line 1, column 8 Перевод: «строка не закончена к концу ввода».jq: parse error: Unfinished string at EOF at line 1, column 20 Перевод: то же.
RapidJSONMissing a closing quotation mark in string. Перевод: «у строки нет закрывающей кавычки».Missing a closing quotation mark in string. Перевод: то же.

Особняком стоит «control character error» у PHP: его сканер считает конец ввода внутри строки запрещённым управляющим символом, и сообщение намекает на кодировку, хотя причина — пропущенная кавычка. Проверено запуском: Node.js 18, 24 и 25.1, Safari 27, Python 3.9 и 3.14, Go 1.25–1.27, Jackson 2.22 и 3.2, System.Text.Json и Newtonsoft.Json 13.0.4, PHP 8.3 и 8.5, serde_json 1.0, jq 1.7 и 1.8. Firefox и RapidJSON — по исходному коду; сообщения Firefox есть и в справочнике Mozilla.

Откуда берутся незакрытые строки

  • Обратный слэш перед закрывающей кавычкой: пути Windows, регулярные выражения, всё, что набрано руками с \ в конце.
  • Фигурная закрывающая кавычка: "готово” открыта прямой кавычкой и «закрыта» ”, а это просто ещё один символ. См. типографские кавычки.
  • Оборванный ввод: ответ, строка лога или копия, остановившиеся посреди строки.
  • Голый перевод строки внутри строки. Большинство парсеров называют это ошибкой управляющего символа, но Safari, Newtonsoft.Json и jq на "b + перевод строки сообщают о незакрытой строке.

Посреди документа обратный слэш в конце строки даёт другую ошибку дальше по тексту: в {"path": "C:\temp\", "user": "Owl"} строка закрывается кавычкой перед user, и парсер спотыкается о слово user. Если ошибка указывает на слово, которое должно быть ключом, поищи обратный слэш перед предыдущей кавычкой.

Как правильно экранировать строки в коде

Сериализаторы экранируют обратные слэши и кавычки сами; проблема появляется, только когда JSON набирают или собирают руками. Каждый сниппет записывает путь из примера как валидный JSON.

JavaScript

const path = "C:\\temp\\";             // путь C:\temp\, в исходном коде слэши удвоены
console.log(JSON.stringify({ path })); // {"path":"C:\\temp\\"}

Python

import json

# Набрано руками: \t молча стал табом.
print("\t" in json.loads(r'{"path": "C:\temp"}')["path"])  # True
print(json.dumps({"path": "C:\\temp\\"}))  # {"path": "C:\\temp\\"}

Go

package main

import (
	"encoding/json"
	"fmt"
)

func main() {
	b, _ := json.Marshal(map[string]string{"path": `C:\temp\`})
	fmt.Println(string(b)) // {"path":"C:\\temp\\"}
}

Java (Jackson)

import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.Map;

String json = new ObjectMapper().writeValueAsString(Map.of("path", "C:\\temp\\"));
System.out.println(json); // {"path":"C:\\temp\\"}

C#

using System.Text.Json;

Console.WriteLine(JsonSerializer.Serialize(new { path = @"C:\temp\" })); // {"path":"C:\\temp\\"}

PHP

$path = 'C:\temp\\';                       // в одинарных кавычках особого внимания требует только \\
echo json_encode(['path' => $path]);  // {"path":"C:\\temp\\"}

Как не оставлять строки открытыми

  • Никогда не вставлять пути, регулярные выражения и пользовательский текст в JSON конкатенацией строк; экранирование оставить сериализатору.
  • В конфигах, которые пишут руками, писать пути Windows прямыми слэшами: "C:/temp/" работает почти во всех API Windows и не требует экранирования.
  • Не пускать JSON в текстовые редакторы и мессенджеры, которые подменяют кавычки.
  • Проверять отредактированные файлы в валидаторе JSON: он показывает, где начинается незакрытая строка.

Проверить в валидаторе

Открыть пример с незакрытой строкой в валидаторе JSON. Он сообщает unclosed_string в конце ввода, добавляет «Кавычка открыта в строке L, колонка C» для кавычки, с которой началась строка, и подсказывает удвоить обратный слэш в конце.

Рядом: неверный escape ("C:\Users"), управляющий символ, типографские кавычки, незакрытая скобка и все ошибки JSON.

Незакрытая строка: частые вопросы

Что значит «Unterminated string in JSON at position»?

Строку открыли кавычкой ", а ввод кончился раньше закрывающей ". Позиция — конец ввода; открывающая кавычка раньше, часто намного раньше.

Почему "C:\temp\" ломает JSON?

Последняя \" — экранированная кавычка, поэтому строка так и не закрывается. Пиши каждый обратный слэш дважды, "C:\\temp\\", или используй прямые слэши.

Может ли строка JSON занимать несколько строк?

Не с настоящими переводами строки: их нужно записывать как \n. Голый перевод строки внутри строки в большинстве парсеров — ошибка управляющего символа.

Почему PHP пишет «Control character error», когда не хватает кавычки?

Его парсер считает конец ввода внутри строки управляющим символом. json_last_error() возвращает 3, но исправление то же: закрыть строку.