ENRU

Ключ без кавычек в 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».
FirefoxJSON.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 Перевод: «ожидалось имя свойства в двойных кавычках».
SafariJSON Parse error: Expected '}' Перевод: «ожидалась }».JSON Parse error: Property name must be a string literal Перевод: «имя свойства должно быть строковым литералом».
PythonExpecting 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 Перевод: «ключ должен быть строкой».
jqjq: 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 похож на него, но строже: это формат данных, а не код.