ENRU

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.6Python 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 idExpecting 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 добавляет пробел после двоеточия.

ЯзыкТакНе так
JavaScriptJSON.stringify({ id: 42 })"{'id': " + id + "}"
Pythonjson.dumps({"id": 42})str({"id": 42})
Gojson.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}}}"
PHPjson_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.1SyntaxError: JSON Parse error: Single quotes (') are not allowed in JSON«Одинарные кавычки в JSON не допускаются» — единственный, кто называет проблему прямо
Go 1.25.3invalid character '\'' looking for beginning of object key string«Недопустимый символ „'“ там, где начинается ключ объекта»
Java, Jackson 2.20.1Unexpected 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.12Syntax error«Синтаксическая ошибка», код 4
jq 1.7.1jq: parse error: Invalid numeric literal at line 1, column 6«Недопустимый числовой литерал в строке 1, колонке 6»
jq 1.8.2jq: 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 на скобке после неё.