ENRU

Висячая запятая в JSON: «Expected double-quoted property name»

Обновлено

Перевод: «ожидалось имя свойства в двойных кавычках». Запятая обещает ещё один элемент. Скобка закрывается, обещание не выполнено, разбор на этом заканчивается. После последнего члена объекта и последнего элемента массива JSON запятую не допускает, поэтому и {"a": 1,}, и [1, 2,] невалидны.

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

Типичная картина: список или объект правили руками, строку под последней удалили или перенесли, а запятая в конце осталась.

{
  "id": "op-0042",
  "tags": ["quiet", "fast",],
  "mercy": false,
}

Удалить нужно две запятые: после "fast" и после false. Больше ничего не меняется:

{
  "id": "op-0042",
  "tags": ["quiet", "fast"],
  "mercy": false
}

Парсер сообщает только о первой ошибке. Исправишь запятую в массиве, запустишь проверку снова, и вторая всплывёт на следующем проходе.

Почему JSON запрещает висячую запятую

В RFC 8259 (раздел 4) запятая — разделитель, а не завершающий знак: «A single comma separates a value from a following name», то есть одна запятая отделяет значение от следующего имени. Грамматика говорит то же для обоих контейнеров: object = begin-object [ member *( value-separator member ) ] end-object и array = begin-array [ value *( value-separator value ) ] end-array. Разделителю нужно что-то с обеих сторон, а после последнего элемента ничего нет.

JavaScript, Python, Go и Rust принимают лишнюю запятую в собственных литералах (Go в многострочных её даже требует), отсюда она и попадает в JSON. Сам JSON грамматику заморозил, чтобы везде читаться одинаково; JSONC и JSON5 её ослабили, но это уже другие форматы.

Сообщения о висячей запятой в разных парсерах

Два одинаковых ввода, {"a": 1,} и [1, 2,], в каждом парсере. Почти все жалуются на то, что идёт после запятой, — на закрывающую скобку: именно там они перестали ждать следующий элемент.

ПарсерОбъект: {"a": 1,}Массив: [1, 2,]
Chrome, Edge, Node.js (V8)Expected double-quoted property name in JSON at position 8 (line 1 column 9) Перевод: «ожидалось имя свойства в двойных кавычках, позиция 8 (строка 1, колонка 9)».Unexpected token ']', "[1, 2,]" is not valid JSON Перевод: «неожиданный токен «]», "[1, 2,]" — невалидный JSON».
Node.js 18, старый Chrome (V8 10.2)Unexpected token } in JSON at position 8 Перевод: «неожиданный токен } в JSON, позиция 8».Unexpected token ] in JSON at position 6 Перевод: «неожиданный токен ] в JSON, позиция 6».
FirefoxJSON.parse: expected double-quoted property name at line 1 column 9 of the JSON data Перевод: «ожидалось имя свойства в двойных кавычках».JSON.parse: unexpected character at line 1 column 7 of the JSON data Перевод: «неожиданный символ».
SafariJSON Parse error: Property name must be a string literal Перевод: «имя свойства должно быть строковым литералом».JSON Parse error: Unexpected comma at the end of array expression Перевод: «неожиданная запятая в конце массива».
Python 3.13 и новееIllegal trailing comma before end of object: line 1 column 8 (char 7) Перевод: «недопустимая висячая запятая перед концом объекта».Illegal trailing comma before end of array: line 1 column 6 (char 5) Перевод: «недопустимая висячая запятая перед концом массива».
Python 3.12 и старшеExpecting property name enclosed in double quotes: line 1 column 9 (char 8) Перевод: «ожидается имя свойства в двойных кавычках».Expecting value: line 1 column 7 (char 6) Перевод: «ожидается значение».
Go (encoding/json)invalid character '}' looking for beginning of object key string Перевод: «недопустимый символ } там, где ищется начало строки-ключа объекта».invalid character ']' looking for beginning of value Перевод: «недопустимый символ ] там, где ищется начало значения».
Java (Jackson 2)Unexpected character ('}' (code 125)): was expecting double-quote to start field name Перевод: «неожиданный символ }, ожидалась двойная кавычка в начале имени поля».Unexpected character (']' (code 93)): expected a valid value (JSON String, Number, Array, Object or token 'null', 'true' or 'false') Перевод: «неожиданный символ ], ожидалось допустимое значение».
C# (System.Text.Json)The JSON object contains a trailing comma at the end which is not supported in this mode. Change the reader options. Перевод: «в объекте JSON висячая запятая, в этом режиме она не поддерживается; измените настройки чтения».The JSON array contains a trailing comma at the end which is not supported in this mode. Change the reader options. Перевод: то же про массив.
C# (Newtonsoft.Json)Ошибки нет: запятая принимается молчаОшибки нет: запятая принимается молча
PHP (json_decode)Syntax error, json_last_error() 4. Перевод: «синтаксическая ошибка».Syntax error, json_last_error() 4. Перевод: «синтаксическая ошибка».
Rust (serde_json)trailing comma at line 1 column 9 Перевод: «висячая запятая, строка 1, колонка 9».trailing comma at line 1 column 7 Перевод: «висячая запятая, строка 1, колонка 7».
jqjq: parse error: Expected another key-value pair at line 1, column 9 Перевод: «ожидалась ещё одна пара ключ-значение».jq: parse error: Expected another array element at line 1, column 7 Перевод: «ожидался ещё один элемент массива».
Visual Studio CodeTrailing comma, проблема 519, подчёркнута сама запятая. Перевод: «висячая запятая».Trailing comma, проблема 519. Перевод: «висячая запятая».

На саму запятую указывают только Python 3.13+ и Visual Studio Code, остальные — на токен после неё. Jackson 3 пишет «property name» вместо «field name». Проверено запуском: Node.js 18, 24 и 25.1 (V8 14.1), Safari 27 (JavaScriptCore, macOS 27), Python 3.9, 3.12, 3.13 и 3.14, Go 1.25–1.27, Jackson 2.22 и 3.2, System.Text.Json и Newtonsoft.Json 13.0.4 на среде выполнения 10.0, PHP 8.3 и 8.5, serde_json 1.0, jq 1.7 и 1.8. Firefox и Visual Studio Code — по исходному коду; сообщения Firefox есть и в справочнике Mozilla.

Откуда берётся висячая запятая

  • Удалили последнюю строку. Строка над ней сохранила запятую и стала последней.
  • Шаблоны. Цикл печатает {{ item }}, для каждого элемента, включая последний. В большинстве шаблонизаторов есть проверка «последняя итерация» или фильтр join.
  • Литералы из кода, вставленные как данные. Объект JavaScript или словарь Python с запятой в конце — валидный код и невалидный JSON.
  • Слияния веток. Две ветки дописали по строке в конец списка, и в итоге запятой на одну больше или на одну меньше (это уже пропущенная запятая).

Как исправить висячую запятую в коде

В данных, которые пишет программа, её быть не должно: любой стандартный сериализатор разделяет элементы и не оставляет запятую в конце. Ниже — как ошибка выглядит при чтении и, где он есть, переключатель, который разрешает висячие запятые в файлах, написанных людьми (у System.Text.Json он описан в документации Microsoft).

JavaScript

// JSON собирают через JSON.stringify, а не склейкой строк: висячих запятых не будет.
const body = JSON.stringify({ tags: ["quiet", "fast"] });
console.log(body); // {"tags":["quiet","fast"]}

try {
  JSON.parse('{"a": 1,}');
} catch (e) {
  console.log(e.message); // Expected double-quoted property name in JSON at position 8 (line 1 column 9)
}

Python

import json

try:
    json.loads('{"a": 1,}')
except json.JSONDecodeError as e:
    # Python 3.13+: "Illegal trailing comma before end of object", e.pos указывает на запятую
    print(e.msg, e.lineno, e.colno)

print(json.dumps({"tags": ["quiet", "fast"]}))  # {"tags": ["quiet", "fast"]}

Go

package main

import (
	"encoding/json"
	"errors"
	"fmt"
)

func main() {
	var v any
	err := json.Unmarshal([]byte(`{"a": 1,}`), &v)
	var se *json.SyntaxError
	if errors.As(err, &se) {
		// Offset — сколько байтов прочитано: 9, сразу за закрывающей скобкой.
		fmt.Println(se.Offset, err)
	}
}

Java (Jackson)

import com.fasterxml.jackson.core.JsonProcessingException;
import com.fasterxml.jackson.databind.ObjectMapper;

ObjectMapper mapper = new ObjectMapper();
try {
    mapper.readTree("{\"a\": 1,}");
} catch (JsonProcessingException e) {
    // 1:9 — закрывающая скобка сразу после запятой
    System.out.println(e.getLocation().getLineNr() + ":" + e.getLocation().getColumnNr());
}

Jackson принимает висячие запятые, только если включить JsonReadFeature.ALLOW_TRAILING_COMMA (см. его функции чтения); для данных от других программ её лучше не включать.

C#

using System.Text.Json;

// Для конфигов, которые пишут люди: разрешить запятую явно.
var options = new JsonDocumentOptions { AllowTrailingCommas = true };
using var doc = JsonDocument.Parse("{\"a\": 1,}", options);
Console.WriteLine(doc.RootElement.GetProperty("a")); // 1

PHP

$json = '{"a": 1,}';
var_dump(json_validate($json)); // bool(false), PHP 8.3+
json_decode($json);
echo json_last_error_msg(), "\n"; // Syntax error

echo json_encode(['tags' => ['quiet', 'fast']]); // {"tags":["quiet","fast"]}

Как не допускать висячих запятых

  • Генерировать JSON сериализатором: JSON.stringify, json.dumps, json.Marshal, Jackson, JsonSerializer, json_encode.
  • В шаблонах склеивать элементы через join, а не дописывать запятую к каждому.
  • Проверять файлы, написанные руками, до выкладки: хуком перед коммитом, шагом CI или валидатором JSON.
  • Если людям правда нужны висячие запятые в конфиге, выбрать формат, где они есть (JSONC, JSON5, YAML), и читать его парсером этого формата, а не JSON-парсером в мягком режиме.

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

Открыть пример с висячей запятой в валидаторе JSON. Он сообщает код trailing_comma со строкой и колонкой самой запятой, а не скобки после неё, а кнопка «Покажи» ставит на неё курсор.

Рядом: пропущенная запятая, комментарии в JSON, незакрытая скобка и полный список ошибок JSON.

Висячая запятая: частые вопросы

Можно ли ставить запятую после последнего элемента в JSON?

Нет. RFC 8259 допускает запятую только между двумя значениями или двумя членами объекта. JSONC и JSON5 её разрешают, но это отдельные форматы, и строгий JSON-парсер их отвергнет.

Почему Chrome пишет «Expected double-quoted property name», хотя свойства нет?

После запятой внутри объекта V8 ждёт следующий ключ, а ключ — строка в двойных кавычках. Вместо него он находит } и сообщает, что ожидал. Причина — запятая перед скобкой.

Почему ошибка указывает на скобку, а не на запятую?

Большинство парсеров понимают, что запятая лишняя, только увидев, что за ней. На саму запятую указывают Python 3.13+, Visual Studio Code и валидатор этого сайта.

Можно просто убрать висячие запятые регулярным выражением?

Только если ни в одной строке документа нет запятой перед скобкой, а это трудно гарантировать. Надёжнее исправить то, что их пишет, или читать файл парсером JSON5 или JSONC.