Неверное число в 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) | 01 | Unexpected number in JSON at position 6 (line 1 column 7). Перевод: «неожиданное число, позиция 6» |
| V8 | .5 | Unexpected token '.', "{"a":.5}" is not valid JSON. Перевод: «неожиданный токен “.”, это не валидный JSON» |
| V8 | 1. | Unterminated fractional number in JSON at position 7 (line 1 column 8). Перевод: «незаконченная дробная часть числа» |
| V8 | 1e | Exponent part is missing a number in JSON at position 7 (line 1 column 8). Перевод: «в экспоненте нет числа» |
| V8 | 0x1F | Expected ',' or '}' after property value in JSON at position 6 (line 1 column 7). Перевод: «после значения свойства ожидалась запятая или }» |
| Firefox (SpiderMonkey) | 01 | expected ',' or '}' after property value in object. Перевод: «после значения свойства ожидалась запятая или }» |
| Firefox | 1. | unterminated fractional number. Перевод: «незаконченная дробная часть» |
| Safari 27 (JavaScriptCore) | 01 | JSON Parse error: Expected '}'. Перевод: «ожидалась }» |
| Safari 27 | 1. | JSON Parse error: Invalid digits after decimal point. Перевод: «неверные цифры после десятичной точки» |
| Python 3.9–3.14 | 01 | Expecting ',' delimiter: line 1 column 7 (char 6). Перевод: «ожидался разделитель “,”» |
| Python 3.9–3.14 | .5, +1 | Expecting value: line 1 column 6 (char 5). Перевод: «ожидалось значение» |
| Go 1.25–1.27 | 01 | invalid character '1' after object key:value pair. Перевод: «недопустимый символ 1 после пары ключ:значение» |
| Go 1.25–1.26 | 1. | invalid character '}' after decimal point in numeric literal. Перевод: «недопустимый символ } после десятичной точки в числе» |
| Go 1.27 | 1., 1e | invalid character '}' in numeric literal. Перевод: «недопустимый символ } в числе» |
| Java, Jackson 2.15–2.23 | 01 | Invalid numeric value: Leading zeroes not allowed. Перевод: «неверное число: ведущие нули запрещены» |
| Jackson | 1. | Unexpected character ('}' (code 125)) in numeric value: Decimal point not followed by a digit. Перевод: «после десятичной точки нет цифры» |
| C#, System.Text.Json 10 | 01 | Invalid leading zero before '1'.. Перевод: «недопустимый ведущий ноль перед 1» |
| System.Text.Json | 0x1F | 'x' is an invalid end of a number. Expected a delimiter.. Перевод: «x не может завершать число, ожидался разделитель» |
| C#, Newtonsoft.Json 13 | 01, .5, 1., 0x1F | Принимает |
| PHP 8.3 | Любой из них | Syntax error. Перевод: «синтаксическая ошибка» |
| Rust, serde_json 1.0 | 01 | invalid number at line 1 column 7. Перевод: «неверное число» |
| jq 1.7.1 | 01, .5, +1, 1. | Принимает |
| jq 1.7.1 | 0x1F | Invalid numeric literal at line 1, column 10. Перевод: «неверный числовой литерал» |
| MySQL 8.4: столбец JSON | 1. | Invalid JSON text: "Miss fraction part in number." at position 7. Перевод: «у числа нет дробной части» |
| MySQL 8.4 | 1e | Invalid 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, и форматирование оставит их ровно как написано.
- Неверный литерал:
NaN,Infinityи-Infinity, которые похожи на числа, но ими не являются. - Нет запятой: так несколько парсеров отвечают на
01и0x1F. - Ключ без кавычек: во что превращается десятичная запятая в
{"price": 1,5}. - Большие числа в JSON
- Все ошибки 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 читается как следующий ключ.