# Expecting property name enclosed in double quotes в Python

> Исправить Expecting property name enclosed in double quotes в Python: str(dict) и одинарные кавычки, висячая запятая, комментарии, ключи без кавычек.

- Адрес: https://jsonstatham.dev/ru/errors/expecting-property-name/
- Язык: Русский (ru)
- Английская версия: https://jsonstatham.dev/errors/expecting-property-name.md
- Обновлено: 2026-11-08

`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)`: [одинарные кавычки](https://jsonstatham.dev/ru/errors/single-quotes/) |
| `{"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)` — «недопустимая висячая запятая перед концом объекта» | [Висячая запятая](https://jsonstatham.dev/ru/errors/trailing-comma/) |
| `{`, а на следующей строке `// user id` | `Expecting property name enclosed in double quotes: line 2 column 3 (char 4)` | то же | [Комментарий](https://jsonstatham.dev/ru/errors/comments/) |
| `{id: 42}` | `Expecting property name enclosed in double quotes: line 1 column 2 (char 1)` | то же | [Ключ без кавычек](https://jsonstatham.dev/ru/errors/unquoted-key/) |
| `{“id”: 42}` | `Expecting property name enclosed in double quotes: line 1 column 2 (char 1)` | то же | [Типографские кавычки](https://jsonstatham.dev/ru/errors/smart-quotes/) из текстового редактора или мессенджера |

В Python 3.13 изменился один случай. У висячей запятой теперь своё сообщение, и оно указывает на саму запятую, на символ раньше; Python 3.12 и более ранние сообщают `Expecting property name` на следующей за ней `}`. Сравни `Lib/json/decoder.py` в [3.12](https://github.com/python/cpython/blob/3.12/Lib/json/decoder.py) и [3.13](https://github.com/python/cpython/blob/3.13/Lib/json/decoder.py).

[RFC 8259](https://www.rfc-editor.org/rfc/rfc8259) говорит прямо: «A name is a string» — имя есть строка, а строка «begins and ends with quotation marks», то есть начинается и кончается символом `"` (`%x22` в грамматике). Одинарные кавычки, слова без кавычек и комментарии под это не подходят, а после запятой обязан идти следующий элемент.

## Главный подозреваемый: str(dict)

Словарь, напечатанный через `str()`, `print()`, f-строку или логирование с `%s`, похож на JSON, но им не является: одинарные кавычки, `True`, `None`. Настоящий JSON пишет `json.dumps`:

```python
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)`.
- Другая программа, которая склеивает строки с одинарными кавычками. Сериализатор есть в любом языке; см. [таблицу ниже](https://jsonstatham.dev/ru/errors/expecting-property-name/#producers).
- `cmd.exe` в Windows, где одинарные кавычки не работают как кавычки: `curl -d '{"id": 42}'` приходит искажённым. Тело лучше положить в файл и отправить через `-d @body.json`.

Не чинить текст через `.replace("'", '"')`. Это ломается на любом апострофе внутри значения и оставляет `True` и `None`; на словаре выше следующей ошибкой будет `Expecting value: line 1 column 18 (char 17)`. Если источник действительно Python и изменить его нельзя, его вывод читается как литерал Python, а не как JSON:

```python
import ast

data = ast.literal_eval(text)
```

[`ast.literal_eval`](https://docs.python.org/3/library/ast.html#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](https://json5.org/), и то и другое отвергает `json`. Их можно убрать или читать файл парсером того формата, в котором он на самом деле написан:

```python
import json5  # pip install json5

data = json5.loads(text)
```

Проверено на json5 0.17.3: комментарии, висячие запятые, ключи без кавычек и одинарные кавычки читаются. Плюсы и минусы — в статье о [комментариях в JSON](https://jsonstatham.dev/ru/guides/json-comments/).

## Найти символ

Исключение хранит позицию числами. Напечатать строку и галочку под нужной колонкой:

```python
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 '<'](https://jsonstatham.dev/ru/errors/unexpected-token/) |

## Попробовать

Открой валидатор с примером [в одинарных кавычках](https://jsonstatham.dev/ru/validator/?sample=single_quotes) или [с висячей запятой](https://jsonstatham.dev/ru/validator/?sample=trailing_comma) — видно, как сообщается каждая ошибка: символ, строка и колонка.

Ещё по теме: [Expecting value](https://jsonstatham.dev/ru/errors/expecting-value/), [комментарии в JSON](https://jsonstatham.dev/ru/guides/json-comments/) и [все ошибки JSON](https://jsonstatham.dev/ru/errors/).

## Вопросы об 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` на скобке после неё.
