Незакрытая строка в 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 Перевод: то же. |
| Firefox | JSON.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 Перевод: то же. |
| Safari | JSON Parse error: Unterminated string Перевод: «незакрытая строка». | JSON Parse error: Unterminated string Перевод: то же. |
| Python | Unterminated 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 Перевод: то же. |
| jq | jq: parse error: Unfinished string at EOF at line 1, column 8 Перевод: «строка не закончена к концу ввода». | jq: parse error: Unfinished string at EOF at line 1, column 20 Перевод: то же. |
| RapidJSON | Missing 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, но исправление то же: закрыть строку.