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

> Исправить неверное число в JSON: ведущие нули, .5, +1, hex и точка в конце, грамматика чисел, точные сообщения парсеров и безопасная запись.

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

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

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

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

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

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

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

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

[RFC 8259, раздел 6](https://www.rfc-editor.org/rfc/rfc8259#section-6) короток и не оставляет зазоров: число записывается «in base 10 using decimal digits», то есть десятичными цифрами; «Leading zeros are not allowed» — ведущие нули запрещены; дробная часть — это точка и хотя бы одна цифра. Грамматика:

```text
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` валидно, хотя [многие парсеры теряют его последние цифры](https://jsonstatham.dev/ru/guides/json-big-numbers/)). Невалидно: плюс впереди, нули перед другими цифрами, точка без цифр с одной из сторон, шестнадцатеричная, восьмеричная и двоичная запись, `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`. Перевод: «у числа нет экспоненты» |
| [Валидатор](https://jsonstatham.dev/ru/validator/) JSON Statham | Любой из них | Неверное число, строка 1, колонка 6, с цитатой всего токена |

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

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

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

### JavaScript

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

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

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

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

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

```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](https://jsonstatham.dev/ru/guides/json-big-numbers/).

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

[Попробовать: открыть пример с неверным числом в валидаторе](https://jsonstatham.dev/ru/validator/?sample=invalid_number). Карточка цитирует токен целиком, `0x1F`, а не только `x`, и указывает на его первый символ. Большие целые и `-0` проходят: это валидный JSON, и форматирование оставит их [ровно как написано](https://jsonstatham.dev/ru/).

- [Неверный литерал](https://jsonstatham.dev/ru/errors/invalid-literal/): `NaN`, `Infinity` и `-Infinity`, которые похожи на числа, но ими не являются.
- [Нет запятой](https://jsonstatham.dev/ru/errors/missing-comma/): так несколько парсеров отвечают на `01` и `0x1F`.
- [Ключ без кавычек](https://jsonstatham.dev/ru/errors/unquoted-key/): во что превращается десятичная запятая в `{"price": 1,5}`.
- [Большие числа в JSON](https://jsonstatham.dev/ru/guides/json-big-numbers/)
- [Все ошибки JSON](https://jsonstatham.dev/ru/errors/)

## Числа в 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` читается как следующий ключ.
