Ключ без кавычек в JSON: «Expected property name»
Обновлено
Перевод: «ожидалось имя свойства или }». Ключ без кавычек — просто слухи. В JSON любой ключ объекта — строка, а строка всегда в двойных кавычках: {"name": 1}, но никогда {name: 1}, даже если ключ — простое слово или число.
Ошибка и исправление
Это валидный JavaScript и невалидный JSON. Обычно такой текст приходит из кода, из консоли или из конфига, который писал человек, привыкший к JavaScript:
{
id: 42,
status: "ready",
2: "second shift"
}Каждый ключ получает двойные кавычки, числовой тоже. Значения остаются как были:
{
"id": 42,
"status": "ready",
"2": "second shift"
}Если и значения в одинарных кавычках, перед тобой литерал JavaScript или Python целиком; исправь заодно одинарные кавычки, а лучше пересобери текст сериализатором.
Почему ключи в JSON обязаны быть в кавычках
RFC 8259, раздел 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.
Откуда берутся ключи без кавычек
console.logв Node.js. Он печатает{ id: 42, items: [ 'tea' ] }— формат для глаз, с голыми ключами и одинарными кавычками.- Литералы объектов, скопированные из кода: фикстуры тестов, истории Storybook, пример из документации.
- Оболочки баз данных и другие инструменты, которые печатают документы в своей похожей на JavaScript нотации.
- Конфиги, написанные руками людьми, привыкшими к JSON5 или YAML, где голые ключи допустимы.
Как получить ключи в кавычках в коде
Сериализатор берёт в кавычки каждый ключ, включая числа: ключи словарей и map выходят строками. В этом же и подвох на обратном пути: после поездки через JSON ключ 1 становится строкой "1".
JavaScript
const order = { id: 42, items: ["tea"] };
console.log(order); // { id: 42, items: [ 'tea' ] } — вывод для осмотра, не JSON
console.log(JSON.stringify(order)); // {"id":42,"items":["tea"]}Python
import json
text = json.dumps({1: "one", 2: "two"})
print(text) # {"1": "one", "2": "two"}
print(json.loads(text)) # ключи вернулись строками: '1', '2'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)
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#
using System.Text.Json;
var m = new Dictionary<int, string> { [1] = "one", [2] = "two" };
Console.WriteLine(JsonSerializer.Serialize(m)); // {"1":"one","2":"two"}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 до того, как оно уйдёт в запрос.
Проверить в валидаторе
Открыть пример с ключом без кавычек в валидаторе JSON. Он сообщает unquoted_key на первом символе ключа, будь то латиница, кириллица, цифра, _ или $.
Рядом: одинарные кавычки, пропущенное двоеточие, висячая запятая (Chrome пишет о ней то же самое), Expecting property name enclosed in double quotes и все ошибки JSON.
Ключи без кавычек: частые вопросы
Нужны ли кавычки у ключей в JSON?
Да, всегда двойные. Ключ JSON — строка, что бы в нём ни было: слово, число, пробел или пустота ("" — допустимый ключ).
Может ли ключ в JSON быть числом?
Только строкой: {"1": "one"}. Сериализаторы так и пишут числовые ключи, а парсеры возвращают их строками.
Почему тот же текст работает как объект JavaScript?
Синтаксис литералов объектов в JavaScript разрешает голые идентификаторы и числа в качестве ключей. JSON похож на него, но строже: это формат данных, а не код.