Одинарные кавычки в 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». |
| Firefox | JSON.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 Перевод: «неожиданный символ». |
| Safari | JSON Parse error: Single quotes (') are not allowed in JSON Перевод: «одинарные кавычки в JSON недопустимы». | JSON Parse error: Single quotes (') are not allowed in JSON Перевод: то же. |
| Python | Expecting 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.8 | jq: 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 — нет, так что текст кажется валидным, пока не попадёт к строгому парсеру.