ENRU

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

Обновлено

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), текст пустойНичего: пустой ответ или файл либо файловый объект, который уже прочиталиОтветы, файлы
line 1 column 1 (char 0), текст не пустойНе JSON: HTML-страница (<), сообщение об ошибке, None, undefinedUnexpected token '<'
line 2 column 1 (char 1) на одном переводе строкиОдни пробельные символы, например пустая последняя строка файла JSON LinesJSON Lines
line 1 column 8 (char 7) в {"ok": True}Литерал Python там, где должно быть значение JSON: True, NoneНедопустимый литерал
line 1 column 10 (char 9) в {"name": 'Ada'}Строка в одинарных кавычкахОдинарные кавычки
line 1 column 7 (char 6) в [1, 2,], Python 3.12 и более ранниеВисячая запятая. Python 3.13 и новее вместо этого пишут Illegal trailing comma before end of array — «недопустимая висячая запятая перед концом массива»Висячая запятая

В терминах RFC 8259 JSON-text = ws value ws: после необязательных пробелов обязано идти значение — false, null, true, объект, массив, число или строка. В пустом тексте его нет, а с <, T или ' не начинается ни одно из них.

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

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

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:

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

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

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

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

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

  • HTTP-вызовы — через одну функцию, которая проверяет статус и тип до .json(), как get_json выше.
  • Файлы писать атомарно: json.dump во временный файл, потом os.replace поверх старого. Читатель никогда не увидит пустой или недописанный файл.
  • При чтении JSON Lines пропускать пустые строки: if line.strip():.
  • В конвейерах проверять returncode до разбора stdout: упавшая команда пишет в stderr и оставляет stdout пустым.
  • Ловить json.JSONDecodeError там, где текст входит в программу, и логировать e.pos вместе с первыми 200 символами — тогда в отчёте будут улики.

Попробовать

Вставь текст в валидатор: он назовёт первый неверный символ со строкой и колонкой. В длинном документе поиск позиции превратит char 18734 в строку и колонку и покажет место.

Ещё по теме: Expecting property name enclosed in double quotes, Unexpected token '<', Unexpected end of JSON input и все ошибки JSON.

Вопросы об 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.