# Ключ без кавычек в JSON: «Expected property name»

> Исправить ключ без кавычек в JSON: почему {name: 1} даёт «Expected property name or '}'» и как брать ключи в кавычки, когда объект JavaScript идёт в JSON.

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

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

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

Это валидный JavaScript и невалидный JSON. Обычно такой текст приходит из кода, из консоли или из конфига, который писал человек, привыкший к JavaScript:

```text
{
  id: 42,
  status: "ready",
  2: "second shift"
}
```

Каждый ключ получает двойные кавычки, числовой тоже. Значения остаются как были:

```json
{
  "id": 42,
  "status": "ready",
  "2": "second shift"
}
```

Если и значения в одинарных кавычках, перед тобой литерал JavaScript или Python целиком; исправь заодно [одинарные кавычки](https://jsonstatham.dev/ru/errors/single-quotes/), а лучше пересобери текст сериализатором.

## Почему ключи в JSON обязаны быть в кавычках

[RFC 8259, раздел 4](https://www.rfc-editor.org/rfc/rfc8259#section-4): «A name is a string» — имя есть строка, а грамматика записывает член объекта как `member = string name-separator value`. Правила для идентификатора там нет, поэтому `name` без кавычек — не ключ и не значение, парсеру некуда его поставить.

Литералы объектов в JavaScript разрешают голые идентификаторы и числа в роли ключей, но JSON намеренно вырезали из JavaScript маленьким: никаких правил для идентификаторов, никаких зарезервированных слов, никакого вопроса, нужны ли кавычки для `class`, `2` или `ключ`. С кавычками ответ всегда «да». Поэтому же ключом в JSON может быть любой текст: с пробелами, точками, эмодзи.

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

Первый ключ без кавычек, `{name: 1}`, и ключ без кавычек после запятой, `{"a": 1, b: 2}`. Многие парсеры описывают эти случаи по-разному, и ни один не говорит слово «кавычки» прямо.

| Парсер | Первый ключ: {name: 1} | После запятой: {"a": 1, b: 2} |
| --- | --- | --- |
| Chrome, Edge, Node.js (V8) | `Expected property name or '}' in JSON at position 1 (line 1 column 2)` Перевод: «ожидалось имя свойства или }». | `Expected double-quoted property name in JSON at position 9 (line 1 column 10)` Перевод: «ожидалось имя свойства в двойных кавычках». |
| Node.js 18, старый Chrome (V8 10.2) | `Unexpected token n in JSON at position 1` Перевод: «неожиданный токен n в JSON, позиция 1». | `Unexpected token b in JSON at position 9` Перевод: «неожиданный токен b в JSON, позиция 9». |
| Firefox | `JSON.parse: expected property name or '}' at line 1 column 2 of the JSON data` Перевод: «ожидалось имя свойства или }». | `JSON.parse: expected double-quoted property name at line 1 column 10 of the JSON data` Перевод: «ожидалось имя свойства в двойных кавычках». |
| Safari | `JSON Parse error: Expected '}'` Перевод: «ожидалась }». | `JSON Parse error: Property name must be a string literal` Перевод: «имя свойства должно быть строковым литералом». |
| Python | `Expecting property name enclosed in double quotes: line 1 column 2 (char 1)` Перевод: «ожидается имя свойства в двойных кавычках». | `Expecting property name enclosed in double quotes: line 1 column 10 (char 9)` Перевод: то же, колонка 10. |
| Go (encoding/json) | `invalid character 'n' looking for beginning of object key string` Перевод: «недопустимый символ n там, где ищется начало ключа». | `invalid character 'b' looking for beginning of object key string` Перевод: то же для b. |
| Java (Jackson 2) | `Unexpected character ('n' (code 110)): was expecting double-quote to start field name` Перевод: «неожиданный символ n, ожидалась двойная кавычка в начале имени поля». | `Unexpected character ('b' (code 98)): was expecting double-quote to start field name` Перевод: то же для b. |
| C# (System.Text.Json) | `'n' is an invalid start of a property name. Expected a '"'.` Перевод: «n не может начинать имя свойства, ожидалась "». | `'b' is an invalid start of a property name. Expected a '"'.` Перевод: то же для b. |
| 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` Перевод: «ключ должен быть строкой». | `key must be a string at line 1 column 10` Перевод: «ключ должен быть строкой». |
| jq | `jq: parse error: Invalid numeric literal at line 1, column 6` Перевод: «неверный числовой литерал». | `jq: parse error: Invalid numeric literal at line 1, column 11` Перевод: «неверный числовой литерал». |

Ответ Safari `Expected '}'` на первый ключ сбивает с толку: со скобками всё в порядке. `Invalid numeric literal` у jq значит, что он пытался прочитать голое слово как число. Проверено запуском: Node.js 18, 24 и 25.1, Safari 27, Python 3.9 и 3.14, Go 1.25–1.27, Jackson 2.22 (Jackson 3 пишет «property name»), System.Text.Json и Newtonsoft.Json 13.0.4, PHP 8.3 и 8.5, serde_json 1.0, jq 1.7 и 1.8; Firefox — по исходному коду и [справочнику Mozilla](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Errors/JSON_bad_parse).

## Откуда берутся ключи без кавычек

- **`console.log` в Node.js.** Он печатает `{ id: 42, items: [ 'tea' ] }` — формат для глаз, с голыми ключами и одинарными кавычками.
- **Литералы объектов, скопированные из кода**: фикстуры тестов, истории Storybook, пример из документации.
- **Оболочки баз данных и другие инструменты**, которые печатают документы в своей похожей на JavaScript нотации.
- **Конфиги, написанные руками** людьми, привыкшими к JSON5 или YAML, где голые ключи допустимы.

## Как получить ключи в кавычках в коде

Сериализатор берёт в кавычки каждый ключ, включая числа: ключи словарей и map выходят строками. В этом же и подвох на обратном пути: после поездки через JSON ключ `1` становится строкой `"1"`.

### JavaScript

```js
const order = { id: 42, items: ["tea"] };
console.log(order);                 // { id: 42, items: [ 'tea' ] } — вывод для осмотра, не JSON
console.log(JSON.stringify(order)); // {"id":42,"items":["tea"]}
```

### Python

```python
import json

text = json.dumps({1: "one", 2: "two"})
print(text)              # {"1": "one", "2": "two"}
print(json.loads(text))  # ключи вернулись строками: '1', '2'
```

### Go

```go
package main

import (
	"encoding/json"
	"fmt"
)

type Order struct {
	ID    int      `json:"id"`
	Items []string `json:"items"`
}

func main() {
	b, _ := json.Marshal(Order{ID: 42, Items: []string{"tea"}})
	fmt.Println(string(b)) // {"id":42,"items":["tea"]}
	b, _ = json.Marshal(map[int]string{1: "one"})
	fmt.Println(string(b)) // {"1":"one"}
}
```

### Java (Jackson)

```java
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.Map;
import java.util.TreeMap;

Map<Integer, String> m = new TreeMap<>(Map.of(1, "one", 2, "two"));
System.out.println(new ObjectMapper().writeValueAsString(m)); // {"1":"one","2":"two"}
```

### C#

```csharp
using System.Text.Json;

var m = new Dictionary<int, string> { [1] = "one", [2] = "two" };
Console.WriteLine(JsonSerializer.Serialize(m)); // {"1":"one","2":"two"}
```

### PHP

```php
echo json_encode([1 => 'one', 2 => 'two']), "\n"; // {"1":"one","2":"two"}
echo json_encode(['one', 'two']);                 // ["one","two"]: ключи 0, 1 дают список
```

Снисходительные парсеры есть: Newtonsoft.Json и парсеры JSON5 принимают голые ключи, Jackson — с `JsonReadFeature.ALLOW_UNQUOTED_FIELD_NAMES`. Используй их для файлов, которые пишут люди, и никогда — как повод отправлять такой текст кому-то ещё.

## Как не допускать ключей без кавычек

- Логировать и копировать `JSON.stringify(value, null, 2)`, а не сам объект.
- Хранить фикстуры файлами `.json`, а не литералами объектов, вставленными в строки.
- Если конфиг пишут люди, честно выбрать JSON5 или YAML и превращать его в JSON при сборке.
- Всё, что скопировано из консоли, проверять в [валидаторе JSON](https://jsonstatham.dev/ru/validator/) до того, как оно уйдёт в запрос.

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

[Открыть пример с ключом без кавычек](https://jsonstatham.dev/ru/validator/?sample=unquoted_key) в валидаторе JSON. Он сообщает `unquoted_key` на первом символе ключа, будь то латиница, кириллица, цифра, `_` или `$`.

Рядом: [одинарные кавычки](https://jsonstatham.dev/ru/errors/single-quotes/), [пропущенное двоеточие](https://jsonstatham.dev/ru/errors/missing-colon/), [висячая запятая](https://jsonstatham.dev/ru/errors/trailing-comma/) (Chrome пишет о ней то же самое), [Expecting property name enclosed in double quotes](https://jsonstatham.dev/ru/errors/expecting-property-name/) и все [ошибки JSON](https://jsonstatham.dev/ru/errors/).

## Ключи без кавычек: частые вопросы

### Нужны ли кавычки у ключей в JSON?

Да, всегда двойные. Ключ JSON — строка, что бы в нём ни было: слово, число, пробел или пустота (`""` — допустимый ключ).

### Может ли ключ в JSON быть числом?

Только строкой: `{"1": "one"}`. Сериализаторы так и пишут числовые ключи, а парсеры возвращают их строками.

### Почему тот же текст работает как объект JavaScript?

Синтаксис литералов объектов в JavaScript разрешает голые идентификаторы и числа в качестве ключей. JSON похож на него, но строже: это формат данных, а не код.
