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

> Исправить висячую запятую в JSON: что значат «Expected double-quoted property name» и «Illegal trailing comma» и как больше её не допускать.

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

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

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

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

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

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

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

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

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

В [RFC 8259](https://www.rfc-editor.org/rfc/rfc8259#section-4) (раздел 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](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Errors/JSON_bad_parse).

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

- **Удалили последнюю строку.** Строка над ней сохранила запятую и стала последней.
- **Шаблоны.** Цикл печатает `{{ item }},` для каждого элемента, включая последний. В большинстве шаблонизаторов есть проверка «последняя итерация» или фильтр join.
- **Литералы из кода, вставленные как данные.** Объект JavaScript или словарь Python с запятой в конце — валидный код и невалидный JSON.
- **Слияния веток.** Две ветки дописали по строке в конец списка, и в итоге запятой на одну больше или на одну меньше (это уже [пропущенная запятая](https://jsonstatham.dev/ru/errors/missing-comma/)).

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

В данных, которые пишет программа, её быть не должно: любой стандартный сериализатор разделяет элементы и не оставляет запятую в конце. Ниже — как ошибка выглядит при чтении и, где он есть, переключатель, который разрешает висячие запятые в файлах, написанных людьми (у System.Text.Json он описан [в документации Microsoft](https://learn.microsoft.com/en-us/dotnet/standard/serialization/system-text-json/invalid-json)).

### JavaScript

```js
// 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

```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

```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)

```java
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` (см. его [функции чтения](https://github.com/FasterXML/jackson-core/wiki/JsonReadFeatures)); для данных от других программ её лучше не включать.

### C#

```csharp
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

```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](https://jsonstatham.dev/ru/validator/).
- Если людям правда нужны висячие запятые в конфиге, выбрать формат, где они есть (JSONC, JSON5, YAML), и читать его парсером этого формата, а не JSON-парсером в мягком режиме.

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

[Открыть пример с висячей запятой](https://jsonstatham.dev/ru/validator/?sample=trailing_comma) в валидаторе JSON. Он сообщает код `trailing_comma` со строкой и колонкой самой запятой, а не скобки после неё, а кнопка «Покажи» ставит на неё курсор.

Рядом: [пропущенная запятая](https://jsonstatham.dev/ru/errors/missing-comma/), [комментарии в JSON](https://jsonstatham.dev/ru/errors/comments/), [незакрытая скобка](https://jsonstatham.dev/ru/errors/unclosed-bracket/) и полный список [ошибок JSON](https://jsonstatham.dev/ru/errors/).

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

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

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

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

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

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

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

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

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