ENRU

Типографские кавычки в 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».
FirefoxJSON.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 Перевод: «незакрытая строка».
SafariJSON Parse error: Unrecognized token '“' Перевод: «нераспознанный токен “».JSON Parse error: Unterminated string Перевод: «незакрытая строка».
PythonExpecting 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.26invalid character 'â' looking for beginning of object key string Перевод: «недопустимый символ â там, где ищется начало ключа».unexpected end of JSON input Перевод: «неожиданный конец ввода JSON».
Go 1.27invalid 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 Перевод: «конец ввода при разборе строки».
jqjq: 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); // Owl

Python

import json

pasted = "{“name”: “Owl”}"
cleaned = pasted.translate(str.maketrans({"“": '"', "”": '"', "„": '"'}))
print(json.loads(cleaned)["name"])  # Owl

Go

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()); // Owl

C#

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")); // Owl

PHP

$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 печатает сам символ.

Можно ли заменять типографские кавычки автоматически?

В общем случае нет: заменятся и законные кавычки и апострофы внутри строк, а в русском тексте «ёлочки» внутри значений — обычное дело. Для разовой вставки — можно с последующей проверкой; если такое приходит регулярно, исправь инструмент, который их ставит.