Expecting property name enclosed in double quotes в Python
Обновлено
json.decoder.JSONDecodeError: Expecting property name enclosed in double quotes: line 1 column 2 (char 1) — модуль json в Python был внутри объекта, сразу после { или запятой, и следующим символом оказалась не ". Перевод: «ожидалось имя свойства в двойных кавычках: строка 1, колонка 2 (символ 1)». Ключи JSON носят двойные кавычки. Этот — нет, или ключа не было вовсе. Чаще всего это не JSON, а словарь Python, напечатанный через str().
Что стоит в этой позиции
Посмотреть на символ в позиции char N, считая с 0. Это одно из пяти:
| Текст | Python 3.9.6 | Python 3.14.10 | Причина |
|---|---|---|---|
{'id': 42} | Expecting property name enclosed in double quotes: line 1 column 2 (char 1) | то же | Одинарные кавычки, обычно от str(dict): одинарные кавычки |
{"id": 42,} | Expecting property name enclosed in double quotes: line 1 column 11 (char 10) | Illegal trailing comma before end of object: line 1 column 10 (char 9) — «недопустимая висячая запятая перед концом объекта» | Висячая запятая |
{, а на следующей строке // user id | Expecting property name enclosed in double quotes: line 2 column 3 (char 4) | то же | Комментарий |
{id: 42} | Expecting property name enclosed in double quotes: line 1 column 2 (char 1) | то же | Ключ без кавычек |
{“id”: 42} | Expecting property name enclosed in double quotes: line 1 column 2 (char 1) | то же | Типографские кавычки из текстового редактора или мессенджера |
В Python 3.13 изменился один случай. У висячей запятой теперь своё сообщение, и оно указывает на саму запятую, на символ раньше; Python 3.12 и более ранние сообщают Expecting property name на следующей за ней }. Сравни Lib/json/decoder.py в 3.12 и 3.13.
RFC 8259 говорит прямо: «A name is a string» — имя есть строка, а строка «begins and ends with quotation marks», то есть начинается и кончается символом " (%x22 в грамматике). Одинарные кавычки, слова без кавычек и комментарии под это не подходят, а после запятой обязан идти следующий элемент.
Главный подозреваемый: str(dict)
Словарь, напечатанный через str(), print(), f-строку или логирование с %s, похож на JSON, но им не является: одинарные кавычки, True, None. Настоящий JSON пишет json.dumps:
import json
payload = {"id": 42, "ok": True, "tags": None}
print(str(payload)) # {'id': 42, 'ok': True, 'tags': None}
print(json.dumps(payload)) # {"id": 42, "ok": true, "tags": null}Где словарь по ошибке превращается в текст:
requests.post(url, data=str(payload)). Вместо этого —json=payload: requests сам сериализует данные и поставитContent-Type: application/json.f.write(str(data))вместоjson.dump(data, f).- Очередь сообщений, кеш или колонка в базе, куда записали
str(obj). - Другая программа, которая склеивает строки с одинарными кавычками. Сериализатор есть в любом языке; см. таблицу ниже.
cmd.exeв Windows, где одинарные кавычки не работают как кавычки:curl -d '{"id": 42}'приходит искажённым. Тело лучше положить в файл и отправить через-d @body.json.
Не чинить текст через .replace("'", '"'). Это ломается на любом апострофе внутри значения и оставляет True и None; на словаре выше следующей ошибкой будет Expecting value: line 1 column 18 (char 17). Если источник действительно Python и изменить его нельзя, его вывод читается как литерал Python, а не как JSON:
import ast
data = ast.literal_eval(text)ast.literal_eval вычисляет только литералы (словари, списки, строки, числа, True, None) и ничего больше, но предназначен для вывода Python, которому ты доверяешь, а не для произвольного ввода.
Настоящий JSON в других языках
Если текст приходит из другой программы, исправлять надо там. Каждый вызов из средней колонки запущен и возвращает {"id":42}; Python добавляет пробел после двоеточия.
| Язык | Так | Не так |
|---|---|---|
| JavaScript | JSON.stringify({ id: 42 }) | "{'id': " + id + "}" |
| Python | json.dumps({"id": 42}) | str({"id": 42}) |
| Go | json.Marshal(map[string]any{"id": 42}) | fmt.Sprintf("{'id': %d}", id) |
| Java (Jackson) | mapper.writeValueAsString(Map.of("id", 42)) | "{'id': " + id + "}" |
| C# | JsonSerializer.Serialize(new { id = 42 }) | $"{{'id': {id}}}" |
| PHP | json_encode(['id' => 42]) | "{'id': $id}" |
Комментарии и висячие запятые в файлах, которые пишут руками
В конфигурационных файлах, которые правят люди, копятся комментарии // и висячие запятые. И то и другое допустимо в JSONC и JSON5, и то и другое отвергает json. Их можно убрать или читать файл парсером того формата, в котором он на самом деле написан:
import json5 # pip install json5
data = json5.loads(text)Проверено на json5 0.17.3: комментарии, висячие запятые, ключи без кавычек и одинарные кавычки читаются. Плюсы и минусы — в статье о комментариях в JSON.
Найти символ
Исключение хранит позицию числами. Напечатать строку и галочку под нужной колонкой:
try:
data = json.loads(text)
except json.JSONDecodeError as e:
line = text.splitlines()[e.lineno - 1]
print(f"{e.msg} at line {e.lineno}, column {e.colno}")
print(line)
print(" " * (e.colno - 1) + "^")Для комментария в третьей строке это напечатает Expecting property name enclosed in double quotes at line 3, column 3, затем строку // owner и галочку под первой косой чертой.
Тот же ввод в других парсерах
{'id': 42} — во всех парсерах, которые удалось запустить для проверки. Два из них его принимают, и так подобный текст доживает до Python:
| Парсер, проверенная версия | Сообщение | Перевод |
|---|---|---|
| Chrome 156, Node.js 25.1 (V8) | SyntaxError: Expected property name or '}' in JSON at position 1 (line 1 column 2) | «Ожидалось имя свойства или „}“ в JSON на позиции 1». Node.js 20 пишет то же без строки и колонки |
| Node.js 18.20 (V8 10.2) | SyntaxError: Unexpected token ' in JSON at position 1 | «Неожиданный токен ' в JSON на позиции 1» — старая формулировка |
| Firefox (исходник: SpiderMonkey) | SyntaxError: JSON.parse: expected property name or '}' at line 1 column 2 of the JSON data | «Ожидалось имя свойства или „}“ в строке 1, колонке 2» |
| Safari, JavaScriptCore из macOS 27.0.1 | SyntaxError: JSON Parse error: Single quotes (') are not allowed in JSON | «Одинарные кавычки в JSON не допускаются» — единственный, кто называет проблему прямо |
| Go 1.25.3 | invalid character '\'' looking for beginning of object key string | «Недопустимый символ „'“ там, где начинается ключ объекта» |
| Java, Jackson 2.20.1 | Unexpected character (''' (code 39)): was expecting double-quote to start field name | «Неожиданный символ „'“ (код 39): имя поля должно начинаться с двойной кавычки» |
| Java, Gson 2.13.2 | ошибки нет | fromJson снисходительно читает одинарные кавычки |
| C#, System.Text.Json 10 (рантайм 10.0.14) | ''' is an invalid start of a property name. Expected a '"'. | «„'“ — недопустимое начало имени свойства, ожидалась „"“». Дальше идёт LineNumber: 0 | BytePositionInLine: 1. |
| C#, Newtonsoft.Json 13.0.4 | ошибки нет | Принимает одинарные кавычки и висячие запятые |
| PHP 8.5.12 | Syntax error | «Синтаксическая ошибка», код 4 |
| jq 1.7.1 | jq: parse error: Invalid numeric literal at line 1, column 6 | «Недопустимый числовой литерал в строке 1, колонке 6» |
| jq 1.8.2 | jq: parse error: Invalid string literal; expected ", but got ' at line 1, column 6 | «Недопустимый строковый литерал: ожидалась ", а встретилась '» |
| FastAPI 0.128.8 на стороне сервера | 422 с "msg":"JSON decode error" и "error":"Expecting property name enclosed in double quotes" | «Ошибка декодирования JSON»: сообщение Python доходит до клиента внутри ответа |
| Flask 3.1.3 на стороне сервера | 400 Bad Request HTML-страницей | Клиент затем падает с Unexpected token '<' |
Попробовать
Открой валидатор с примером в одинарных кавычках или с висячей запятой — видно, как сообщается каждая ошибка: символ, строка и колонка.
Ещё по теме: Expecting value, комментарии в JSON и все ошибки JSON.
Вопросы об Expecting property name
Что значит «Expecting property name enclosed in double quotes»?
Перевод: «ожидалось имя свойства в двойных кавычках». Внутри объекта, после { или запятой, Python ждал ключ в двойных кавычках и встретил другое: одинарную кавычку, закрывающую скобку после висячей запятой, комментарий или слово без кавычек.
Как превратить словарь Python в JSON?
json.dumps(d) — в строку, json.dump(d, f) — в файл. Никогда не str(d): он пишет одинарные кавычки, True и None.
Можно ли научить json в Python принимать одинарные кавычки?
Нет, такой настройки нет. Исправлять источник. Если это вывод Python, которому ты доверяешь, — ast.literal_eval; для конфига, написанного руками, — парсер JSON5.
Почему тот же файл на Python 3.13 падает с другой ошибкой?
Python 3.13 сообщает о висячей запятой как Illegal trailing comma before end of object и указывает на саму запятую; более ранние версии пишут Expecting property name на скобке после неё.