Висячая запятая в 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». |
| Firefox | JSON.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 Перевод: «неожиданный символ». |
| Safari | JSON 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». |
| jq | jq: 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 Code | Trailing 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")); // 1PHP
$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.