ENRU

Неверное число в JSON: почему 01, .5, +1 и 0x1F не проходят и как исправить

Обновлено

У чисел в JSON одно написание. 01, .5, +1 и 0x1F — чужие. Number() в JavaScript прочтёт все четыре; JSON же принимает десятичные цифры, один необязательный минус, точку с цифрами по обе стороны и экспоненту — и больше ничего.

Числа, которые JavaScript читает, а JSON отвергает

Каждое значение в этом объекте где-то считается числом: почтовый индекс с ведущим нулём, дробь без нуля, явный плюс, шестнадцатеричная маска, точка в конце. Числом JSON не является ни одно:

{"zip": 02134, "ratio": .5, "delta": +1, "mask": 0x1F, "total": 10.}

Исправленная версия. Индекс стал строкой, потому что его ведущий ноль — это данные; остальное переписано обычными десятичными числами:

{"zip": "02134", "ratio": 0.5, "delta": 1, "mask": 31, "total": 10.0}

Грамматика чисел JSON (RFC 8259)

RFC 8259, раздел 6 короток и не оставляет зазоров: число записывается «in base 10 using decimal digits», то есть десятичными цифрами; «Leading zeros are not allowed» — ведущие нули запрещены; дробная часть — это точка и хотя бы одна цифра. Грамматика:

number = [ minus ] int [ frac ] [ exp ]
int    = zero / ( digit1-9 *DIGIT )
frac   = decimal-point 1*DIGIT
exp    = e [ minus / plus ] 1*DIGIT

Валидно: 0, -0, 0.5, 10.0, 1e5, 1E-7, 1e+5 и целые любой длины (12345678901234567890 валидно, хотя многие парсеры теряют его последние цифры). Невалидно: плюс впереди, нули перед другими цифрами, точка без цифр с одной из сторон, шестнадцатеричная, восьмеричная и двоичная запись, 1_000 и десятичная запятая.

Десятичная запятая заслуживает отдельного предупреждения. {"price": 1,5} падает, но не как число: после 1, парсер ждёт следующий ключ и находит 5. А в массиве [1,5] совершенно валиден и означает два числа, 1 и 5, — так что ошибка может пройти любую проверку.

Ошибки неверного числа в разных парсерах

Каждый ввод стоит внутри {"a":…}, поэтому плохое число начинается с символа с индексом 5. Сообщения получены запуском парсеров 8 ноября 2026 года, у Firefox — по исходникам SpiderMonkey. В таблице — один-два показательных случая на парсер, а не все сочетания.

ПарсерВводСообщение
Chrome 156, Node 24–25 (V8)01Unexpected number in JSON at position 6 (line 1 column 7). Перевод: «неожиданное число, позиция 6»
V8.5Unexpected token '.', "{"a":.5}" is not valid JSON. Перевод: «неожиданный токен “.”, это не валидный JSON»
V81.Unterminated fractional number in JSON at position 7 (line 1 column 8). Перевод: «незаконченная дробная часть числа»
V81eExponent part is missing a number in JSON at position 7 (line 1 column 8). Перевод: «в экспоненте нет числа»
V80x1FExpected ',' or '}' after property value in JSON at position 6 (line 1 column 7). Перевод: «после значения свойства ожидалась запятая или }»
Firefox (SpiderMonkey)01expected ',' or '}' after property value in object. Перевод: «после значения свойства ожидалась запятая или }»
Firefox1.unterminated fractional number. Перевод: «незаконченная дробная часть»
Safari 27 (JavaScriptCore)01JSON Parse error: Expected '}'. Перевод: «ожидалась }»
Safari 271.JSON Parse error: Invalid digits after decimal point. Перевод: «неверные цифры после десятичной точки»
Python 3.9–3.1401Expecting ',' delimiter: line 1 column 7 (char 6). Перевод: «ожидался разделитель “,”»
Python 3.9–3.14.5, +1Expecting value: line 1 column 6 (char 5). Перевод: «ожидалось значение»
Go 1.25–1.2701invalid character '1' after object key:value pair. Перевод: «недопустимый символ 1 после пары ключ:значение»
Go 1.25–1.261.invalid character '}' after decimal point in numeric literal. Перевод: «недопустимый символ } после десятичной точки в числе»
Go 1.271., 1einvalid character '}' in numeric literal. Перевод: «недопустимый символ } в числе»
Java, Jackson 2.15–2.2301Invalid numeric value: Leading zeroes not allowed. Перевод: «неверное число: ведущие нули запрещены»
Jackson1.Unexpected character ('}' (code 125)) in numeric value: Decimal point not followed by a digit. Перевод: «после десятичной точки нет цифры»
C#, System.Text.Json 1001Invalid leading zero before '1'.. Перевод: «недопустимый ведущий ноль перед 1»
System.Text.Json0x1F'x' is an invalid end of a number. Expected a delimiter.. Перевод: «x не может завершать число, ожидался разделитель»
C#, Newtonsoft.Json 1301, .5, 1., 0x1FПринимает
PHP 8.3Любой из нихSyntax error. Перевод: «синтаксическая ошибка»
Rust, serde_json 1.001invalid number at line 1 column 7. Перевод: «неверное число»
jq 1.7.101, .5, +1, 1.Принимает
jq 1.7.10x1FInvalid numeric literal at line 1, column 10. Перевод: «неверный числовой литерал»
MySQL 8.4: столбец JSON1.Invalid JSON text: "Miss fraction part in number." at position 7. Перевод: «у числа нет дробной части»
MySQL 8.41eInvalid JSON text: "Miss exponent in number." at position 7. Перевод: «у числа нет экспоненты»
Валидатор JSON StathamЛюбой из нихНеверное число, строка 1, колонка 6, с цитатой всего токена

Полезная закономерность: на 01 и 0x1F многие парсеры жалуются вовсе не на число. Они читают 0 как законченное число и спотыкаются на 1 или x, поэтому в сообщении речь о пропущенной запятой. Invalid numeric literal у jq — ловушка обратного рода: jq пишет это про всё, с чего не может начать значение, включая < HTML-страницы.

Как записывать числа, которые JSON примет

Сериализаторы никогда не пишут 01 или .5; беда начинается, когда число вставляют в текст JSON как набрали. Нужно сверить текст с грамматикой и записать строкой, если не совпало. Фрагменты запущены, в комментариях — их вывод.

JavaScript

const jsonNumber = /^-?(0|[1-9]\d*)(\.\d+)?([eE][+-]?\d+)?$/;

function numberOrString(raw) {
  return jsonNumber.test(raw) ? raw : JSON.stringify(raw);
}

numberOrString('0.5'); // 0.5
numberOrString('.5'); // ".5"
numberOrString('02134'); // "02134"

Python

import json
import re

json_number = re.compile(r"-?(0|[1-9]\d*)(\.\d+)?([eE][+-]?\d+)?")


def number_or_string(raw):
    return raw if json_number.fullmatch(raw) else json.dumps(raw)


print(number_or_string("1e3"), number_or_string("+1"), number_or_string("0x1F"))  # 1e3 "+1" "0x1F"

Go

import (
	"encoding/json"
	"regexp"
)

var jsonNumber = regexp.MustCompile(`^-?(0|[1-9]\d*)(\.\d+)?([eE][+-]?\d+)?$`)

func numberOrString(raw string) string {
	if jsonNumber.MatchString(raw) {
		return raw
	}
	quoted, _ := json.Marshal(raw)
	return string(quoted)
}

Java (Jackson)

import com.fasterxml.jackson.core.JsonProcessingException;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.regex.Pattern;

static final Pattern JSON_NUMBER = Pattern.compile("-?(0|[1-9]\\d*)(\\.\\d+)?([eE][+-]?\\d+)?");

static String numberOrString(ObjectMapper mapper, String raw) throws JsonProcessingException {
    return JSON_NUMBER.matcher(raw).matches() ? raw : mapper.writeValueAsString(raw);
}

C#

using System.Text.Json;
using System.Text.RegularExpressions;

static string NumberOrString(string raw) =>
    Regex.IsMatch(raw, @"^-?(0|[1-9]\d*)(\.\d+)?([eE][+-]?\d+)?\z") ? raw : JsonSerializer.Serialize(raw);

System.Text.Json по умолчанию экранирует + в строках, так что "+1" выходит как "\u002B1": та же строка, записанная осторожнее.

PHP

function number_or_string(string $raw): string
{
    return preg_match('/^-?(0|[1-9]\d*)(\.\d+)?([eE][+-]?\d+)?\z/', $raw) === 1
        ? $raw
        : json_encode($raw, JSON_THROW_ON_ERROR);
}

Чтобы значение осталось числом, его переводят до записи: parseInt("1F", 16) в JavaScript, int("1F", 16) в Python, strconv.ParseInt в Go, Integer.parseInt("1F", 16) в Java, Convert.ToInt32("1F", 16) в C#, hexdec("1F") в PHP — все дают 31.

Как не пускать неверные числа в JSON

  • Коды — это строки. Почтовые индексы, телефоны, номера счетов и карт, всё, где 007 не равно 7, пишутся в кавычках.
  • Не форматировать числа для людей внутри JSON. Локальное форматирование пишет 1,5 или 1 000; разделители разрядов и десятичная запятая нужны в интерфейсе, а не в данных.
  • Переводить на границе. Шестнадцатеричное с устройства, +1 из формы, 1. из таблицы стоит превратить в обычные десятичные там, где они входят в систему.
  • Сохранять большие числа точно. 19-значный идентификатор — валидный JSON, но JSON.parse его округлит; подробнее — большие числа в JSON.

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

Попробовать: открыть пример с неверным числом в валидаторе. Карточка цитирует токен целиком, 0x1F, а не только x, и указывает на его первый символ. Большие целые и -0 проходят: это валидный JSON, и форматирование оставит их ровно как написано.

Числа в JSON: частые вопросы

Можно ли ведущие нули в числах JSON?

Только одиночный 0 перед десятичной точкой, как в 0.5. 01, 007 и -01 невалидны; коды вроде "02134" хранятся строками.

Может ли число в JSON начинаться с точки или плюса?

Нет: 0.5, а не .5; 1, а не +1. Минус впереди разрешён, плюс — только в экспоненте, как в 1e+5.

Поддерживает ли JSON шестнадцатеричные числа?

Нет, только десятичные. Вместо 0x1F пишется 31, или шестнадцатеричный текст хранится строкой "0x1F".

1,5 — валидное число в JSON?

Нет, в JSON дробная часть отделяется точкой. Внутри массива [1,5] валиден, но это два числа, 1 и 5; внутри объекта {"a": 1,5} падает, потому что 5 читается как следующий ключ.