Типографские кавычки в JSON: «Unexpected token» на фигурной кавычке
Обновлено
Перевод: «неожиданный токен “». Красивые кавычки. Не те. Для тебя “ или « — кавычка, для парсера JSON — случайный символ: ему нужна прямая " (U+0022) и ничего похожего на неё.
Ошибка и исправление
JSON, побывавший в текстовом редакторе, мессенджере или на клавиатуре телефона, часто возвращается таким. На экране разница — пара пикселей:
{“name”: “Owl”, “ready”: true}Каждая фигурная двойная кавычка должна стать прямой:
{"name": "Owl", "ready": true}От того, где стоит типографская кавычка, зависит и ошибка. На месте кавычки, открывающей ключ или значение, — это ошибка типографских кавычек. В роли закрывающей у строки, открытой прямой ", как в {"a": "b”}, она просто ещё один символ строки: строка не кончается, и парсер сообщает о незакрытой строке в конце ввода.
Какие символы считаются типографскими кавычками
| Символ | Код | Откуда берётся |
|---|---|---|
“ и ” | U+201C, U+201D | Автозамена в английской раскладке: Word, Google Docs, Pages, умная пунктуация macOS и iOS |
„ | U+201E | «Лапки» немецкой и русской типографики: открывающая кавычка внизу |
‘ и ’ | U+2018, U+2019 | Та же автозамена для одинарных кавычек; ’ — ещё и типографский апостроф |
« и » | U+00AB, U+00BB | «Ёлочки»: автозамена в русском Word, Google Docs и мессенджерах |
Внутри строки все они допустимы и остаются как есть: {"quote": "«Готово»"} — валидный JSON. Ломают документ они только там, где синтаксис требует кавычку.
Почему JSON не принимает типографские кавычки
RFC 8259 называет единственный символ, который открывает и закрывает строку: quotation-mark = %x22. JSON определён на кодовых точках, а не на начертании, и « — это U+00AB, другой символ с другой записью в UTF-8 (два байта, C2 AB), а “ — U+201C (три байта, E2 80 9C). Парсер, угадывающий, какую похожую кавычку ты имел в виду, читал бы текст иначе, чем соседний, а для формата данных это недопустимо.
Сообщения о типографских кавычках в разных парсерах
Два ввода: фигурная кавычка там, где начинается ключ, {“a”: 1}, и фигурная закрывающая после прямой открывающей, {"a": "b”}. Второй везде становится незакрытой строкой.
| Парсер | Ключ: {“a”: 1} | Закрывающая: {"a": "b”} |
|---|---|---|
| Chrome, Edge, Node.js (V8) | Expected property name or '}' in JSON at position 1 (line 1 column 2) Перевод: «ожидалось имя свойства или }». На месте значения: Unexpected token '“', "{"a": “b”}" is not valid JSON, «неожиданный токен “». | Unterminated string in JSON at position 10 (line 1 column 11) Перевод: «незакрытая строка в JSON, позиция 10». |
| Node.js 18, старый Chrome (V8 10.2) | Unexpected token “ in JSON at position 1 Перевод: «неожиданный токен “ в JSON, позиция 1». | Unexpected end of JSON input Перевод: «неожиданный конец ввода JSON». |
| Firefox | JSON.parse: expected property name or '}' at line 1 column 2 of the JSON data Перевод: «ожидалось имя свойства или }». | JSON.parse: unterminated string at line 1 column 11 of the JSON data Перевод: «незакрытая строка». |
| Safari | JSON Parse error: Unrecognized token '“' Перевод: «нераспознанный токен “». | JSON Parse error: Unterminated string Перевод: «незакрытая строка». |
| Python | Expecting property name enclosed in double quotes: line 1 column 2 (char 1) Перевод: «ожидается имя свойства в двойных кавычках». | Unterminated string starting at: line 1 column 7 (char 6) Перевод: «незакрытая строка, начинается в строке 1, колонке 7». |
| Go 1.25 и 1.26 | invalid character 'â' looking for beginning of object key string Перевод: «недопустимый символ â там, где ищется начало ключа». | unexpected end of JSON input Перевод: «неожиданный конец ввода JSON». |
| Go 1.27 | invalid character '“' looking for beginning of object key string Перевод: «недопустимый символ “ там, где ищется начало ключа». | unexpected end of JSON input Перевод: «неожиданный конец ввода JSON». |
| Java (Jackson 2) | Unexpected character ('“' (code 8220 / 0x201c)): was expecting double-quote to start field name Перевод: «неожиданный символ “, ожидалась двойная кавычка в начале имени поля». | Unexpected end-of-input: was expecting closing quote for a string value Перевод: «неожиданный конец ввода, ожидалась закрывающая кавычка строки». |
| C# (System.Text.Json) | '0xE2' is an invalid start of a property name. Expected a '"'. Перевод: «0xE2 не может начинать имя свойства, ожидалась "». | Expected end of string, but instead reached end of data. Перевод: «ожидался конец строки, а данные кончились». |
| C# (Newtonsoft.Json) | Invalid property identifier character: “. Path '', line 1, position 1. Перевод: «недопустимый символ в имени свойства: “». | Unterminated string. Expected delimiter: ". Path 'a', line 1, position 10. Перевод: «незакрытая строка, ожидался разделитель "». |
| PHP (json_decode) | Syntax error, json_last_error() 4. Перевод: «синтаксическая ошибка». | Control character error, possibly incorrectly encoded, json_last_error() 3. Перевод: «ошибка управляющего символа, возможно, неверная кодировка». |
| Rust (serde_json) | key must be a string at line 1 column 2 Перевод: «ключ должен быть строкой». | EOF while parsing a string at line 1 column 12 Перевод: «конец ввода при разборе строки». |
| jq | jq: parse error: Invalid numeric literal at line 1, column 9 Перевод: «неверный числовой литерал». | jq: parse error: Unfinished string at EOF at line 1, column 12 Перевод: «строка не закончена к концу ввода». |
Две строки здесь — отдельные загадки. Go до 1.27 и System.Text.Json сообщают первый байт последовательности UTF-8: â — это байт E2, прочитанный как Latin-1, а 0xE2 — тот же байт в шестнадцатеричной записи. Serde и jq считают колонки в байтах, поэтому каждая фигурная кавычка сдвигает их колонку на два. Проверено запуском: Node.js 18, 24 и 25.1, Safari 27, Python 3.9 и 3.14, Go 1.25, 1.26 и 1.27, Jackson 2.22, System.Text.Json и Newtonsoft.Json 13.0.4, PHP 8.3 и 8.5, serde_json 1.0, jq 1.7 и 1.8; Firefox — по исходному коду и справочнику Mozilla.
Как заменить типографские кавычки в коде
Для разовой вставки замени фигурные двойные кавычки “ ” „ на " и проверь результат. ‘ ’ не трогай: ’ внутри строки гораздо чаще апостроф, чем сломанный разделитель. С «ёлочками» осторожнее вдвойне: в русском тексте они законно стоят внутри строк, и слепая замена их испортит; добавляй « » в набор, только если уверен, что внутри значений их нет. Для данных, которые приходят регулярно, чинить надо источник.
JavaScript
const pasted = "{“name”: “Owl”}";
const cleaned = pasted.replace(/[\u201C\u201D\u201E]/g, '"');
console.log(JSON.parse(cleaned).name); // OwlPython
import json
pasted = "{“name”: “Owl”}"
cleaned = pasted.translate(str.maketrans({"“": '"', "”": '"', "„": '"'}))
print(json.loads(cleaned)["name"]) # OwlGo
package main
import (
"encoding/json"
"fmt"
"strings"
)
func main() {
pasted := "{“name”: “Owl”}"
cleaned := strings.NewReplacer("“", `"`, "”", `"`, "„", `"`).Replace(pasted)
var v map[string]string
fmt.Println(json.Unmarshal([]byte(cleaned), &v), v["name"]) // <nil> Owl
}Java (Jackson)
import com.fasterxml.jackson.databind.ObjectMapper;
String pasted = "{“name”: “Owl”}";
String cleaned = pasted.replaceAll("[“”„]", "\"");
System.out.println(new ObjectMapper().readTree(cleaned).get("name").asText()); // OwlC#
using System.Text.Json;
using System.Text.RegularExpressions;
var pasted = "{“name”: “Owl”}";
var cleaned = Regex.Replace(pasted, "[“”„]", "\"");
Console.WriteLine(JsonDocument.Parse(cleaned).RootElement.GetProperty("name")); // OwlPHP
$pasted = '{“name”: “Owl”}';
$cleaned = str_replace(['“', '”', '„'], '"', $pasted);
echo json_decode($cleaned, true)['name']; // OwlКак отучить редакторы подменять кавычки
- macOS: Системные настройки › Клавиатура › Ввод текста, кнопка изменения источников ввода, там выключить смарт-кавычки и тире.
- iPhone и iPad: Настройки › Основные › Клавиатура, выключить смарт-пунктуацию.
- Microsoft Word: Файл › Параметры › Правописание › Параметры автозамены, вкладка автоформата при вводе: выключить замену прямых кавычек парными.
- Google Документы: Инструменты › Настройки, выключить смарт-кавычки.
- Мессенджеры и вики: отправляй JSON блоком кода или файлом; в блоке кода кавычки остаются прямыми.
- Держи JSON в редакторе кода, а не в документе, и проверяй его в валидаторе JSON, прежде чем отправлять дальше.
Проверить в валидаторе
Открыть пример с фигурными кавычками в валидаторе JSON. Он сообщает smart_quotes, показывает, какой символ нашёл, а кнопка «Покажи» ставит на него курсор — это выручает, когда разница не видна глазом.
Рядом: одинарные кавычки, незакрытая строка, неожиданный символ для других двойников и все ошибки JSON.
Типографские кавычки в JSON: частые вопросы
Что такое типографские кавычки?
Кавычки вроде “ ”, „ “ и « », которые редакторы и клавиатуры ставят вместо прямых " и '. Они похожи, но это другие символы.
Могут ли в JSON вообще быть «ёлочки» или фигурные кавычки?
Да, внутри строки: "«Готово»" — валидная строка. Прямыми должны быть только кавычки, которые открывают и закрывают ключи и строки.
Почему Go печатает â вместо фигурной кавычки?
Go 1.26 и старше печатает первый байт символа так, будто это Latin-1. “ начинается с байта E2, а в Latin-1 это â. Go 1.27 печатает сам символ.
Можно ли заменять типографские кавычки автоматически?
В общем случае нет: заменятся и законные кавычки и апострофы внутри строк, а в русском тексте «ёлочки» внутри значений — обычное дело. Для разовой вставки — можно с последующей проверкой; если такое приходит регулярно, исправь инструмент, который их ставит.