ENRU

Пропущенное двоеточие в JSON: «Expected … after property name»

Обновлено

Перевод: «после имени свойства ожидалось :». Ключ. Двоеточие. Значение. Именно так. Внутри объекта JSON за каждым ключом идёт :, а затем значение; всё остальное после ключа, будь то =, =>, сразу значение или запятая, останавливает парсер на месте.

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

Три разные привычки, одна ошибка. Каждая строка ниже падает на символе после ключа:

{"port" = 8080}
{"port" => 8080}
{"port" 8080}

В JSON это пишется всегда одинаково:

{"port": 8080}

Четвёртая привычка самая коварная. {"red", "green"} выглядит как список, но фигурные скобки открывают объект, поэтому "red" читается как ключ, а запятая после него — как пропущенное двоеточие. Список в JSON — массив: ["red", "green"].

Зачем JSON двоеточие

RFC 8259, раздел 4: «A single colon comes after each name, separating the name from the value» — после каждого имени ровно одно двоеточие, отделяющее имя от значения, а в грамматике member = string name-separator value, где разделитель имени — :. Сокращений нет: ни ключа без значения, ни другого разделителя, ни значения true по умолчанию.

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

Значение сразу после ключа, {"a" 1}, и знак равенства вместо двоеточия, {"a" = 1}:

Парсер{"a" 1}{"a" = 1}
Chrome, Edge, Node.js (V8)Expected ':' after property name in JSON at position 5 (line 1 column 6) Перевод: «после имени свойства ожидалось :».Expected ':' after property name in JSON at position 5 (line 1 column 6) Перевод: то же.
Node.js 18, старый Chrome (V8 10.2)Unexpected number in JSON at position 5 Перевод: «неожиданное число в JSON, позиция 5».Unexpected token = in JSON at position 5 Перевод: «неожиданный токен = в JSON, позиция 5».
FirefoxJSON.parse: expected ':' after property name in object at line 1 column 6 of the JSON data Перевод: «после имени свойства в объекте ожидалось :».JSON.parse: expected ':' after property name in object at line 1 column 6 of the JSON data Перевод: то же.
SafariJSON Parse error: Expected ':' before value in object property definition Перевод: «в определении свойства объекта перед значением ожидалось :».JSON Parse error: Expected ':' before value in object property definition Перевод: то же.
PythonExpecting ':' delimiter: line 1 column 6 (char 5) Перевод: «ожидается разделитель :».Expecting ':' delimiter: line 1 column 6 (char 5) Перевод: то же.
Go (encoding/json)invalid character '1' after object key Перевод: «недопустимый символ 1 после ключа объекта».invalid character '=' after object key Перевод: «недопустимый символ = после ключа объекта».
Java (Jackson 2)Unexpected character ('1' (code 49)): was expecting a colon to separate field name and value Перевод: «неожиданный символ 1, ожидалось двоеточие между именем поля и значением».Unexpected character ('=' (code 61)): was expecting a colon to separate field name and value Перевод: то же для =.
C# (System.Text.Json)'1' is invalid after a property name. Expected a ':'. Перевод: «1 недопустимо после имени свойства, ожидалось :».'=' is invalid after a property name. Expected a ':'. Перевод: то же для =.
C# (Newtonsoft.Json)Invalid character after parsing property name. Expected ':' but got: 1. Path '', line 1, position 5. Перевод: «недопустимый символ после имени свойства: ожидалось :, получено 1».Invalid character after parsing property name. Expected ':' but got: =. Path '', line 1, position 5. Перевод: то же для =.
PHP (json_decode)Syntax error, json_last_error() 4. Перевод: «синтаксическая ошибка».Syntax error, json_last_error() 4. Перевод: «синтаксическая ошибка».
Rust (serde_json)expected : at line 1 column 6. Перевод: «ожидалось :».expected : at line 1 column 6. Перевод: «ожидалось :».
jqjq: parse error: Expected separator between values at line 1, column 7 Перевод: «ожидался разделитель между значениями».jq: parse error: Invalid numeric literal at line 1, column 7 Перевод: «неверный числовой литерал».
RapidJSONMissing a colon after a name of object member. Перевод: «после имени члена объекта нет двоеточия».Missing a colon after a name of object member. Перевод: то же.

Это одна из немногих ошибок, которую почти все парсеры называют правильно. Исключения — старый V8, описывающий неожиданный токен, и jq, у которого «разделитель» здесь означает двоеточие. Для «множества» {"red", "green"} Chrome и Python выдают те же сообщения о двоеточии и указывают на запятую. Проверено запуском: 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 и RapidJSON — по исходному коду; сообщения Firefox есть и в справочнике Mozilla.

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

  • = из других форматов: файлы .ini и .env, переменные оболочки, query-строки URL.
  • => из кода: массивы PHP и хеши Ruby, напечатанные через inspect, выглядят почти как JSON.
  • Множество или список в фигурных скобках: множества Python, инициализаторы коллекций C# и многие языки конфигурации пишут список как {a, b}.
  • Ключ без значения, например после поиска с заменой, который удалил : null, или шаблона, напечатавшего пустое значение. Ключ, за которым сразу }, даёт ту же ошибку.

Как получить двоеточие в коде

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

JavaScript

// Строки key=value: собрать объект, а двоеточия пусть пишет JSON.stringify.
const lines = "debug=true\nport=8080".split("\n");
console.log(JSON.stringify(Object.fromEntries(lines.map((l) => l.split("="))))); // {"debug":"true","port":"8080"}

// У Set нет собственных ключей: JSON.stringify пишет для него {}.
const colors = new Set(["red", "green"]);
console.log(JSON.stringify(colors), JSON.stringify(Array.from(colors))); // {} ["red","green"]

Python

import json

colors = {"red", "green"}  # множество: скобки фигурные, но ключей нет
try:
    json.dumps(colors)
except TypeError as e:
    print(e)  # Object of type set is not JSON serializable
print(json.dumps(sorted(colors)))  # ["green", "red"]

Go

package main

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

func main() {
	pairs := map[string]string{}
	for _, line := range strings.Split("debug=true\nport=8080", "\n") {
		k, v, _ := strings.Cut(line, "=")
		pairs[k] = v
	}
	b, _ := json.Marshal(pairs)
	fmt.Println(string(b)) // {"debug":"true","port":"8080"}
}

Java (Jackson)

import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.List;
import java.util.Set;
import java.util.TreeSet;

Set<String> colors = new TreeSet<>(List.of("red", "green"));
System.out.println(new ObjectMapper().writeValueAsString(colors)); // ["green","red"]

C#

using System.Text.Json;

var colors = new SortedSet<string> { "red", "green" };
Console.WriteLine(JsonSerializer.Serialize(colors)); // ["green","red"]

PHP

$config = ['debug' => true, 'port' => 8080]; // в PHP пишут key => value
echo json_encode($config);                    // {"debug":true,"port":8080}

Как держать двоеточия на месте

  • Не переводить форматы поиском с заменой: = на : сломается на первом значении, где есть =.
  • Если значение неизвестно, писать null, а не ничего.
  • Списки — в [ ], фигурные скобки { } — только для пар ключ-значение.
  • Прогонять файлы, правленные руками, через валидатор JSON перед коммитом.

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

Открыть пример с пропущенным двоеточием в валидаторе JSON. Он сообщает missing_colon на символе, который стоит на месте :, и показывает, что именно там нашёл.

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

Пропущенное двоеточие: частые вопросы

Можно ли в JSON писать = вместо :?

Нет. Двоеточие — единственный разделитель между ключом и значением. = принадлежит файлам .ini и .env и query-строкам.

Может ли у ключа в JSON не быть значения?

Нет. Каждому ключу нужно значение; если его нет, пиши null. Одинокий ключ парсер считает пропущенным двоеточием.

Почему {"red", "green"} — пропущенное двоеточие, а не список?

Фигурные скобки в JSON всегда открывают объект, а объект хранит пары ключ-значение. Парсер читает "red" как ключ и ждёт после него двоеточие. Списки пишутся в квадратных скобках.