ENRU

Пропущенная запятая в JSON: «Expected … after property value»

Обновлено

Перевод: «после значения свойства ожидалась , или }». Два значения без запятой. Кто-то должен уступить. JSON отделяет запятой каждый член объекта и каждый элемент массива, а когда её нет, парсер останавливается на начале следующего значения — обычно строкой ниже того места, которое надо исправить.

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

В конец добавили новую строку, а строка над ней так и осталась без запятой:

{
  "id": "op-0042",
  "status": "in progress"
  "eta_minutes": 12
}

Chrome сообщает line 4 column 3, Python — line 4 column 3, и оба указывают на "eta_minutes". А запятая нужна в конце строки 3:

{
  "id": "op-0042",
  "status": "in progress",
  "eta_minutes": 12
}

Правило на каждый день: если ошибка указывает на начало строки, читай конец строки над ней. Парсер не может знать, что запятой нет, пока не увидит начало следующего значения.

Зачем JSON запятая между значениями

RFC 8259 собирает оба контейнера из элементов и разделителей: для массивов «Elements are separated by commas», элементы разделяются запятыми, для объектов «A single comma separates a value from a following name». Пробелы и переводы строк в JSON ничего не разделяют: они допустимы вокруг структурных символов и игнорируются. Перевод строки на месте запятой — просто пробельный символ, и два значения оказываются вплотную.

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

Два однострочных ввода: {"a": 1 "b": 2} и [1 2]. Все позиции ниже указывают на второе значение, а не на промежуток перед ним.

ПарсерОбъект: {"a": 1 "b": 2}Массив: [1 2]
Chrome, Edge, Node.js (V8)Expected ',' or '}' after property value in JSON at position 8 (line 1 column 9) Перевод: «после значения свойства ожидалась , или }».Expected ',' or ']' after array element in JSON at position 3 (line 1 column 4) Перевод: «после элемента массива ожидалась , или ]».
Node.js 18, старый Chrome (V8 10.2)Unexpected string in JSON at position 8 Перевод: «неожиданная строка в JSON, позиция 8».Unexpected number in JSON at position 3 Перевод: «неожиданное число в JSON, позиция 3».
FirefoxJSON.parse: expected ',' or '}' after property value in object at line 1 column 9 of the JSON data Перевод: «после значения свойства в объекте ожидалась , или }».JSON.parse: expected ',' or ']' after array element at line 1 column 4 of the JSON data Перевод: «после элемента массива ожидалась , или ]».
SafariJSON Parse error: Expected '}' Перевод: «ожидалась }».JSON Parse error: Expected ']' Перевод: «ожидалась ]».
PythonExpecting ',' delimiter: line 1 column 9 (char 8) Перевод: «ожидается разделитель ,».Expecting ',' delimiter: line 1 column 4 (char 3) Перевод: «ожидается разделитель ,».
Go (encoding/json)invalid character '"' after object key:value pair Перевод: «недопустимый символ " после пары ключ:значение».invalid character '2' after array element Перевод: «недопустимый символ 2 после элемента массива».
Java (Jackson 2)Unexpected character ('"' (code 34)): was expecting comma to separate Object entries Перевод: «неожиданный символ ", ожидалась запятая между членами объекта».Unexpected character ('2' (code 50)): was expecting comma to separate Array entries Перевод: «неожиданный символ 2, ожидалась запятая между элементами массива».
C# (System.Text.Json)'"' is invalid after a value. Expected either ',', '}', or ']'. Перевод: «" недопустима после значения, ожидалась , } или ]».'2' is invalid after a value. Expected either ',', '}', or ']'. Перевод: «2 недопустимо после значения».
C# (Newtonsoft.Json)After parsing a value an unexpected character was encountered: ". Path 'a', line 1, position 8. Перевод: «после значения встретился неожиданный символ "».After parsing a value an unexpected character was encountered: 2. Path '[0]', line 1, position 3. Перевод: «после значения встретился неожиданный символ 2».
PHP (json_decode)Syntax error, json_last_error() 4. Перевод: «синтаксическая ошибка».Syntax error, json_last_error() 4. Перевод: «синтаксическая ошибка».
Rust (serde_json)expected , or } at line 1 column 9. Перевод: «ожидалась , или }».expected , or ] at line 1 column 4. Перевод: «ожидалась , или ]».
jqjq: parse error: Expected separator between values at line 1, column 11 Перевод: «ожидался разделитель между значениями».jq: parse error: Expected separator between values at line 1, column 5 Перевод: «ожидался разделитель между значениями».
RapidJSONMissing a comma or '}' after an object member. Перевод: «после члена объекта нет запятой или }».Missing a comma or ']' after an array element. Перевод: «после элемента массива нет запятой или ]».

Safari называет закрывающую скобку, которую ждал, и молчит о запятой; Node.js 18 сообщает лишь, какой тип значения его удивил. Проверено запуском: Node.js 18, 24 и 25.1, Safari 27, Python 3.9 и 3.14, Go 1.25–1.27, Jackson 2.22 (Jackson 3 пишет так же), System.Text.Json и Newtonsoft.Json 13.0.4, PHP 8.3 и 8.5, serde_json 1.0, jq 1.7 и 1.8. Firefox и RapidJSON — по исходному коду; сообщения Firefox есть и в справочнике Mozilla.

Откуда берётся пропущенная запятая

  • Дописали строку в конец объекта или массива. Зеркальная висячая запятая: у последней строки запятой не было, новой последней она не нужна, а старой теперь нужна.
  • Слияния и копирование целых строк между файлами.
  • Массивы, собранные в цикле без разделителя, так что внутри [ ] оказывается }{.
  • Двойная кавычка внутри строки без экранирования. В {"title": "The "Owl" case"} строка кончается после The , и Chrome выдаёт ту же «Expected ',' or '}'» на следующем слове. Экранируй её как \".

Два значения подряд на верхнем уровне, например {} {} или по объекту JSON на строку, — другая ошибка: разделять их не в чем, контейнера нет. Это лишнее после JSON.

Как найти пропущенную запятую в коде

Само исправление — один символ. Трудно найти место в большом документе, поэтому сниппеты ниже печатают строку над указанной позицией: скорее всего, запятая нужна именно там.

JavaScript

const text = '{\n  "a": 1\n  "b": 2\n}';
try {
  JSON.parse(text);
} catch (e) {
  // V8 дописывает к сообщению "(line L column C)" (текущий Chrome, Node.js 24 и новее).
  const line = Number(/line (\d+)/.exec(e.message)?.[1]);
  console.log(text.split("\n")[line - 2]); //   "a": 1   (запятая нужна в конце)
}

Python

import json

text = '{\n  "a": 1\n  "b": 2\n}'
try:
    json.loads(text)
except json.JSONDecodeError as e:
    print(e.msg, e.lineno, e.colno)         # Expecting ',' delimiter 3 3
    print(text.splitlines()[e.lineno - 2])  # строка над ошибкой

Go

package main

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

func main() {
	text := "{\n  \"a\": 1\n  \"b\": 2\n}"
	var v any
	err := json.Unmarshal([]byte(text), &v)
	var se *json.SyntaxError
	if errors.As(err, &se) {
		line := strings.Count(text[:se.Offset], "\n") + 1
		fmt.Println(err, "on line", line) // invalid character '"' after object key:value pair on line 3
	}
}

Java (Jackson)

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

String text = "{\n  \"a\": 1\n  \"b\": 2\n}";
try {
    new ObjectMapper().readTree(text);
} catch (JsonProcessingException e) {
    int line = e.getLocation().getLineNr(); // 3
    System.out.println(text.split("\n")[line - 2]); // строка над ошибкой
}

C#

using System.Text.Json;

var text = "{\n  \"a\": 1\n  \"b\": 2\n}";
try {
    JsonDocument.Parse(text);
} catch (JsonException e) {
    // LineNumber считается с нуля: 2 — это третья строка.
    var line = (int)e.LineNumber.GetValueOrDefault();
    Console.WriteLine(text.Split('\n')[line - 1]); // строка над ошибкой
}

PHP

$text = "{\n  \"a\": 1\n  \"b\": 2\n}";
json_decode($text);
echo json_last_error_msg(); // Syntax error: позиции нет вовсе
// PHP не скажет где; вставь текст в валидатор, который скажет.

Как не терять запятые

  • Отдать разделители сериализатору; никогда не склеивать элементы конкатенацией строк.
  • Правя руками, сначала ставить запятую в старую последнюю строку, потом добавлять новую.
  • После правки форматировать документ: когда каждый член на своей строке, пропуск видно по концам строк.
  • Проверять правки в валидаторе JSON или в CI до того, как они попадут в продакшен.

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

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

Рядом: висячая запятая, пропущенное двоеточие, лишнее после JSON, не та скобка (у Chrome для неё то же сообщение) и все ошибки JSON.

Пропущенная запятая: частые вопросы

Почему ошибка указывает не на ту строку?

Она указывает на следующее значение: только там парсер узнаёт, что запятой нет. Смотри конец строки перед ним.

Что значит «Expected … after property value» в Chrome?

После значения внутри объекта V8 может принять только запятую (дальше ещё член) или } (объект кончился). Он нашёл другое: обычно следующий ключ без запятой перед ним, иногда неэкранированную кавычку в строке или скобку не того вида.

Что такое «Unexpected string in JSON at position»?

Старая формулировка той же ошибки в V8, её до сих пор печатает Node.js 18: строка началась там, где ждали запятую или закрывающую скобку.

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

Нет. Переводы строк — пробельные символы и в JSON ничего не значат. Только JSON Lines кладёт по одному значению на строку, и запятых между такими значениями нет совсем.