# Expecting value: line 1 column 1 (char 0) в Python

> Исправить Expecting value: line 1 column 1 (char 0) в Python: прочитать позицию, проверить ответ requests или файл и разбирать только настоящий JSON.

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

`json.decoder.JSONDecodeError: Expecting value: line 1 column 1 (char 0)` — модуль `json` в Python искал значение в первом символе и не нашёл ничего знакомого. Перевод: «ожидалось значение: строка 1, колонка 1 (символ 0)». Текст пустой или начинается с того, что не является JSON. В requests та же ошибка выглядит как `requests.exceptions.JSONDecodeError: Expecting value: line 1 column 1 (char 0)` и почти всегда значит, что сервер прислал не JSON. Python поискал. Найти было нечего.

## Сначала — позиция

`Expecting value` возникает везде, где должно начинаться значение: в начале, после двоеточия, после запятой или `[`. Позиция подсказывает, какой это случай. `char` считает символы с 0, `line` и `column` — с 1, так что `char 0` — это строка 1, колонка 1. Проверено на Python 3.9.6 и 3.14.10:

| Сообщение кончается на | Что стоит в этом месте | Куда дальше |
| --- | --- | --- |
| `line 1 column 1 (char 0)`, текст пустой | Ничего: пустой ответ или файл либо файловый объект, который уже прочитали | [Ответы](https://jsonstatham.dev/ru/errors/expecting-value/#requests), [файлы](https://jsonstatham.dev/ru/errors/expecting-value/#files) |
| `line 1 column 1 (char 0)`, текст не пустой | Не JSON: HTML-страница (`<`), сообщение об ошибке, `None`, `undefined` | [Unexpected token '<'](https://jsonstatham.dev/ru/errors/unexpected-token/) |
| `line 2 column 1 (char 1)` на одном переводе строки | Одни пробельные символы, например пустая последняя строка файла JSON Lines | [JSON Lines](https://jsonstatham.dev/ru/guides/json-lines/) |
| `line 1 column 8 (char 7)` в `{"ok": True}` | Литерал Python там, где должно быть значение JSON: `True`, `None` | [Недопустимый литерал](https://jsonstatham.dev/ru/errors/invalid-literal/) |
| `line 1 column 10 (char 9)` в `{"name": 'Ada'}` | Строка в одинарных кавычках | [Одинарные кавычки](https://jsonstatham.dev/ru/errors/single-quotes/) |
| `line 1 column 7 (char 6)` в `[1, 2,]`, Python 3.12 и более ранние | Висячая запятая. Python 3.13 и новее вместо этого пишут `Illegal trailing comma before end of array` — «недопустимая висячая запятая перед концом массива» | [Висячая запятая](https://jsonstatham.dev/ru/errors/trailing-comma/) |

В терминах [RFC 8259](https://www.rfc-editor.org/rfc/rfc8259) `JSON-text = ws value ws`: после необязательных пробелов обязано идти значение — `false`, `null`, `true`, объект, массив, число или строка. В пустом тексте его нет, а с `<`, `T` или `'` не начинается ни одно из них.

## С requests: сначала посмотреть на ответ

`response.json()` не проверяет ни статус, ни тип содержимого: разбирает всё, что пришло. Распечатать, что пришло:

```python
import requests

r = requests.get(url, timeout=10)
print(r.status_code, r.headers.get("Content-Type"), len(r.content))
print(r.history, r.url)
print(r.text[:300])
```

- `204` и длина `0`: тела нет. На ответе 204 `.json()` не вызывать.
- `200 text/html` и непустой `r.history`: requests прошёл по редиректу, обычно на страницу входа.
- `403 text/html`: файрвол или защита от ботов. Скрипту не хватает заголовка, cookie или токена, которые отправляет браузер.
- `500`, `502` или `503` с HTML или текстом: сервер упал, а в теле написано, как именно.
- `200 application/json` — и всё равно ошибка: тело пустое или битое. Смотреть таблицу позиций выше.

С версии requests 2.27 `requests.exceptions.JSONDecodeError` наследует и от `json.JSONDecodeError`, и от `requests.RequestException`, так что её ловит любой из двух `except`, и это по-прежнему `ValueError`. httpx 0.28.1 бросает обычную `json.JSONDecodeError`. aiohttp 3.13.5 сначала проверяет тип содержимого и бросает `ContentTypeError: 200, message='Attempt to decode JSON with unexpected mimetype: text/html; charset=utf-8'` («попытка разобрать JSON с неожиданным типом содержимого»), вообще не начиная разбор.

Исправление то же, что в любом языке: статус и тип до разбора. Прогнано на тестовом сервере с ответами JSON, HTML, HTML-ошибкой 500 и пустым 204:

```python
import requests

def get_json(url, **kwargs):
    r = requests.get(url, timeout=10, **kwargs)
    ctype = r.headers.get("Content-Type", "")
    if r.ok and "json" in ctype:
        return r.json()
    raise RuntimeError(f"{r.status_code} {ctype} from {r.url}: {repr(r.text[:200])}")
```

## С файлами: проверить, что открыто на самом деле

- **Пустой файл.** `os.path.getsize(path)` равен 0: файл создали, но ничего не записали, или сбой оставил его обрезанным.
- **Файл, который уже прочитали.** После `f.read()` позиция стоит в конце, и `json.load(f)` видит пустую строку — ошибка на `char 0`. Вызвать `f.seek(0)` или разобрать уже прочитанный текст.
- **Не тот файл.** Относительный путь, разрешённый от другой рабочей папки, или веб-страница, сохранённая как `.json`: ссылка GitHub с `/blob/` скачивает страницу вокруг файла, а не сам файл.
- **Метка порядка байтов (BOM)** даёт своё сообщение, `Unexpected UTF-8 BOM (decode using utf-8-sig)` — «неожиданная метка BOM, декодируйте через utf-8-sig». Открывать файл с `encoding="utf-8-sig"`; см. [BOM](https://jsonstatham.dev/ru/errors/bom/).

```python
import json
from pathlib import Path

path = Path("data.json")
raw = path.read_bytes()
print(path.resolve(), len(raw), raw[:80])
data = json.loads(raw.decode("utf-8-sig"))
```

Три напечатанных значения отвечают на вопросы, какой файл открыт, какого он размера и с чего начинается; декодирование через `utf-8-sig` заодно убирает метку BOM, если она есть. Из командной строки `python -m json.tool data.json` печатает то же сообщение с позицией, а Python 3.14 понимает и короткое `python -m json`. Подробнее — в [документации модуля json](https://docs.python.org/3/library/json.html#module-json.tool).

## Тот же ввод в других языках

Сообщение Python — самое расплывчатое из распространённых парсеров: пустое тело, веб-страница и литерал Python дают одно и то же `Expecting value`. Другие языки называют символ, и это помогает, когда на руках только строка лога:

| Ввод | Python 3.9.6 и 3.14.10 | JavaScript, V8 (Node.js 25.1) | Go 1.25.3 |
| --- | --- | --- | --- |
| пусто | `Expecting value: line 1 column 1 (char 0)` | `Unexpected end of JSON input` | `unexpected end of JSON input` |
| HTML-страница | `Expecting value: line 1 column 1 (char 0)` | `Unexpected token '<', "<!DOCTYPE "... is not valid JSON` | `invalid character '<' looking for beginning of value` |
| `None` | `Expecting value: line 1 column 1 (char 0)` | `Unexpected token 'N', "None" is not valid JSON` | `invalid character 'N' looking for beginning of value` |
| `{"ok": True}` | `Expecting value: line 1 column 8 (char 7)` | `Unexpected token 'T', "{"ok": True}" is not valid JSON` | `invalid character 'T' looking for beginning of value` |
| `{"name": 'Ada'}` | `Expecting value: line 1 column 10 (char 9)` | `Unexpected token ''', "{"name": 'Ada'}" is not valid JSON` | `invalid character '\'' looking for beginning of value` |

## Как не допустить

- HTTP-вызовы — через одну функцию, которая проверяет статус и тип до `.json()`, как `get_json` выше.
- Файлы писать атомарно: `json.dump` во временный файл, потом `os.replace` поверх старого. Читатель никогда не увидит пустой или недописанный файл.
- При чтении [JSON Lines](https://jsonstatham.dev/ru/guides/json-lines/) пропускать пустые строки: `if line.strip():`.
- В конвейерах проверять `returncode` до разбора `stdout`: упавшая команда пишет в stderr и оставляет stdout пустым.
- Ловить [`json.JSONDecodeError`](https://docs.python.org/3/library/json.html#json.JSONDecodeError) там, где текст входит в программу, и логировать `e.pos` вместе с первыми 200 символами — тогда в отчёте будут улики.

## Попробовать

Вставь текст в [валидатор](https://jsonstatham.dev/ru/validator/?sample=unexpected_character): он назовёт первый неверный символ со строкой и колонкой. В длинном документе [поиск позиции](https://jsonstatham.dev/ru/json-position/) превратит `char 18734` в строку и колонку и покажет место.

Ещё по теме: [Expecting property name enclosed in double quotes](https://jsonstatham.dev/ru/errors/expecting-property-name/), [Unexpected token '<'](https://jsonstatham.dev/ru/errors/unexpected-token/), [Unexpected end of JSON input](https://jsonstatham.dev/ru/errors/unexpected-end-of-json-input/) и [все ошибки JSON](https://jsonstatham.dev/ru/errors/).

## Вопросы об Expecting value

### Что значит «Expecting value: line 1 column 1 (char 0)»?

Перевод: «ожидалось значение: строка 1, колонка 1 (символ 0)». Python не нашёл значения JSON в самом первом символе. Текст пустой или начинается не с JSON — чаще всего это HTML-страница от сервера.

### Почему response.json() падает, если запрос прошёл успешно?

Статус 200 ничего не говорит о теле. Там может быть страница входа после редиректа или вообще ничего. До разбора распечатать `r.status_code`, `r.headers.get("Content-Type")` и `r.text[:300]`.

### Как поймать эту ошибку?

Ловить `json.JSONDecodeError`; с requests подойдёт и `requests.exceptions.JSONDecodeError`. Обе — подклассы `ValueError`, так что старый код, который ловит `ValueError`, продолжает работать.

### «char 0» — это первый символ?

Да. `char` — индекс в тексте с нуля, а `line` и `column` начинаются с 1. Исключение хранит все три как `e.pos`, `e.lineno` и `e.colno`.
