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, undefined | Unexpected token '<' |
line 2 column 1 (char 1) на одном переводе строки | Одни пробельные символы, например пустая последняя строка файла JSON Lines | JSON 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.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 пропускать пустые строки:
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.