ENRU

Одинарные кавычки в JSON: «Expecting property name enclosed in double quotes»

Обновлено

Перевод: «ожидается имя свойства в двойных кавычках». JSON знает один вид кавычек, и это не он. Ключи и строки в JSON берутся в прямые двойные кавычки " и ни во что другое: {'name': 'Owl'} — это словарь Python или литерал JavaScript, но не JSON.

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

Чаще всего такой текст — вывод print() или str() словаря в Python, вставленный туда, где ждали JSON:

{'name': 'Owl', 'ready': True, 'backup': None}

Одной заменой кавычек не обойтись: True и None — тоже слова Python, в JSON они пишутся true и null (неверный литерал). Настоящий JSON для тех же данных:

{"name": "Owl", "ready": true, "backup": null}

Почему JSON принимает только двойные кавычки

RFC 8259, раздел 7: «A string begins and ends with quotation marks» — строка начинается и заканчивается кавычкой. Грамматика называет ровно один символ, quotation-mark = %x22, прямую двойную кавычку. Ключи объекта по тому же правилу — строки («A name is a string»), значит, и кавычки у них те же.

JavaScript разрешает выбирать между ' и "; JSON выбрал одно, чтобы парсеру не приходилось угадывать, где кончается строка, а апостроф внутри строки был просто символом. Надстройки над JSON вроде JSON5 одинарные кавычки возвращают, сам JSON их не принимал никогда.

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

Одинарная кавычка на месте ключа, {'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 Перевод: «неожиданный токен ', … невалидный JSON».
Node.js 18, старый Chrome (V8 10.2)Unexpected token ' in JSON at position 1 Перевод: «неожиданный токен ' в JSON, позиция 1».Unexpected token ' in JSON at position 6 Перевод: «неожиданный токен ' в JSON, позиция 6».
FirefoxJSON.parse: expected property name or '}' at line 1 column 2 of the JSON data Перевод: «ожидалось имя свойства или }».JSON.parse: unexpected character at line 1 column 7 of the JSON data Перевод: «неожиданный символ».
SafariJSON Parse error: Single quotes (') are not allowed in JSON Перевод: «одинарные кавычки в JSON недопустимы».JSON Parse error: Single quotes (') are not allowed in JSON Перевод: то же.
PythonExpecting property name enclosed in double quotes: line 1 column 2 (char 1) Перевод: «ожидается имя свойства в двойных кавычках».Expecting value: line 1 column 7 (char 6) Перевод: «ожидается значение».
Go (encoding/json)invalid character '\'' looking for beginning of object key string Перевод: «недопустимый символ ' там, где ищется начало ключа».invalid character '\'' looking for beginning of value Перевод: «недопустимый символ ' там, где ищется начало значения».
Java (Jackson 2)Unexpected character (''' (code 39)): was expecting double-quote to start field name Перевод: «неожиданный символ ', ожидалась двойная кавычка в начале имени поля».Unexpected character (''' (code 39)): expected a valid value (JSON String, Number, Array, Object or token 'null', 'true' or 'false') Перевод: «ожидалось допустимое значение».
C# (System.Text.Json)''' is an invalid start of a property name. Expected a '"'. Перевод: «' не может начинать имя свойства, ожидалась "».''' is an invalid start of a value. Перевод: «' не может начинать значение».
C# (Newtonsoft.Json)Ошибки нет: одинарные кавычки принимаютсяОшибки нет: одинарные кавычки принимаются
PHP (json_decode)Syntax error, json_last_error() 4. Перевод: «синтаксическая ошибка».Syntax error, json_last_error() 4. Перевод: «синтаксическая ошибка».
Rust (serde_json)key must be a string at line 1 column 2 Перевод: «ключ должен быть строкой».expected value at line 1 column 7 Перевод: «ожидалось значение».
jq 1.8jq: parse error: Invalid string literal; expected ", but got ' at line 1, column 5 Перевод: «неверный строковый литерал: ожидалась ", получена '».jq: parse error: Invalid string literal; expected ", but got ' at line 1, column 10 Перевод: то же.

Кавычку называют только Safari и jq 1.8; jq 1.7 на том же вводе пишет Invalid numeric literal. Newtonsoft.Json читает одинарные кавычки без возражений, поэтому такой «JSON» живёт в одном сервисе и ломается в следующем. Проверено запуском: Node.js 18, 24 и 25.1, Safari 27, Python 3.9 и 3.14, Go 1.25–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.

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

  • print(), str(), repr() или f-строка со словарём в Python. Это синтаксис Python: одинарные кавычки, True, False, None. Собственный модуль json его не читает.
  • JSON, собранный в коде руками: шаблонная строка или конкатенация, где одинарные кавычки проще набрать, чем экранированные двойные.
  • Команды в терминале. curl -d "{'name': 'Owl'}" избавляет от экранирования внутри двойных кавычек и отправляет невалидный JSON.
  • Снисходительные парсеры по пути. Newtonsoft.Json, Jackson с JsonReadFeature.ALLOW_SINGLE_QUOTES, парсеры JSON5 и YAML принимают одинарные кавычки, и проблема всплывает только у строгого парсера.

Как исправить одинарные кавычки в коде

Заменить каждую ' на " — ловушка: строку с апострофом Python печатает в двойных кавычках, и замена ломает именно такие значения. Исправлять нужно код, который выдал этот текст, и писать JSON сериализатором своего языка.

Python

import ast
import json

data = {"name": "Owl", "ready": True, "backup": None}
print(str(data))         # {'name': 'Owl', 'ready': True, 'backup': None}
print(json.dumps(data))  # {"name": "Owl", "ready": true, "backup": null}

# Есть только напечатанный словарь из лога? Это литерал Python: так его и читай.
text = "{'name': 'Owl', 'ready': True, 'backup': None}"
print(json.dumps(ast.literal_eval(text)))

JavaScript

const user = { name: "Owl", ready: true };
// Шаблонная строка — не сериализатор: кавычки и экранирование на тебе.
const handMade = `{'name': '${user.name}'}`;
console.log(handMade);             // {'name': 'Owl'}, это не JSON
console.log(JSON.stringify(user)); // {"name":"Owl","ready":true}

Go

package main

import (
	"encoding/json"
	"fmt"
)

func main() {
	m := map[string]any{"name": "Owl", "ready": true}
	fmt.Printf("%v\n", m) // map[name:Owl ready:true] — синтаксис Go
	b, _ := json.Marshal(m)
	fmt.Println(string(b)) // {"name":"Owl","ready":true}
}

Java (Jackson)

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

Map<String, Object> m = new LinkedHashMap<>();
m.put("name", "Owl");
m.put("ready", true);
System.out.println(m);                                        // {name=Owl, ready=true}
System.out.println(new ObjectMapper().writeValueAsString(m)); // {"name":"Owl","ready":true}

C#

using System.Text.Json;

var user = new { name = "Owl", ready = true };
Console.WriteLine(user);                           // { name = Owl, ready = True }
Console.WriteLine(JsonSerializer.Serialize(user)); // {"name":"Owl","ready":true}

PHP

$user = ['name' => 'Owl', 'ready' => true];
var_export($user);              // синтаксис PHP, одинарные кавычки
echo "\n", json_encode($user); // {"name":"Owl","ready":true}

Терминал (curl)

# Одинарные кавычки вокруг тела — для оболочки, двойные внутри — для JSON.
curl -X POST https://example.com/api/users -H "Content-Type: application/json" -d '{"name": "Owl"}'

Как не пускать одинарные кавычки в JSON

  • Никогда не печатать словарь, map или объект и не называть результат JSON: в лог — json.dumps(data), а не data.
  • Тело запроса собирать сериализатором, даже если в нём одно поле.
  • В тестах читать JSON строгим парсером, чтобы мягкий в продакшене не прятал проблему.
  • Подозрительный текст вставлять в валидатор JSON: он называет проблему single_quotes, а не безликим «неожиданным символом».

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

Открыть пример с одинарными кавычками в валидаторе JSON: он останавливается на первой ', сообщает single_quotes со строкой и колонкой и подсказывает json.dumps(), если текст пришёл из Python.

Рядом: типографские кавычки, ключ без кавычек, неверный литерал (True, None, NaN), отдельный разбор сообщения Python Expecting property name enclosed in double quotes и все ошибки JSON.

Одинарные кавычки в JSON: частые вопросы

Можно ли в JSON использовать одинарные кавычки?

Нет. Ключи и строки — только в прямых двойных кавычках. Внутри строки в двойных кавычках одинарная кавычка — обычный символ.

Что значит «Expecting property name enclosed in double quotes» в Python?

На месте, где должен начаться ключ, Python нашёл не ". Обычные причины: одинарные кавычки из str(dict), ключ без кавычек, висячая запятая перед } или комментарий.

Как превратить строку со словарём Python в JSON?

Если есть сам словарь — json.dumps(data). Если только его напечатанный текст — разобрать через ast.literal_eval и затем json.dumps; кавычки руками не менять.

Почему этот JSON работает в C# и падает в других местах?

Newtonsoft.Json по умолчанию принимает одинарные кавычки. System.Text.Json, браузеры, Python и Go — нет, так что текст кажется валидным, пока не попадёт к строгому парсеру.