调用json.loads()解析接口返回的内容,抛出json.decoder.JSONDecodeError: Expecting value: line 1 column 1 (char 0)。第一反应多半是JSON格式写错了,把字符串翻来覆去检查引号和逗号,其实column 1 char 0这串位置信息已经说得很明白:解析器在第一个字符就没找到值的开头,传进去的东西压根不是JSON。
json.decoder.JSONDecodeError: Expecting value: line 1 column 1 (char 0) File "parse_resp.py", line 12, in <module> data = json.loads(resp.text)
这个报错在对接第三方接口时遇到过不止一次,十次里有八次问题不在json模块这一侧。
1、先把真正传进去的内容打出来
别急着改解析代码,先确认resp.text里到底是什么。用repr()能看到肉眼看不见的字符,配合status_code、Content-Type一起看:
print(resp.status_code, resp.headers.get('Content-Type'))
print(repr(resp.text[:300]))
常见的几种结果:打印出来是空字符串,说明接口这次返回了空body,可能是限流、鉴权失效或者上游超时,网关给个200却没内容;打印出来是<html>开头的一大段,那是错误页或者登录页被当成JSON收下了,502、504、SSO跳转页都长这样;还有返回了一段带提示文字的JSONP或者日志行,同样不是合法JSON。之前接手过一个定时任务,白天跑得好好的,凌晨上游发版返回了nginx的502页面,脚本直接栽在这一行,repr()打出来一眼就看清了。
requests的resp.json()内部也是调json.loads,报的是同一个异常。先拿resp.raise_for_status()把非2xx挡掉,再看resp.text,比直接resp.json()省事。Content-Type里写着text/html就别再往json.loads里塞了。
2、报错串里的行号列号怎么读
Expecting value后面那串line 1 column 1 (char 0)不是摆设。Python 3.5起json模块把原来的ValueError换成了JSONDecodeError,异常对象多了pos、lineno、colno、doc四个属性,pos是出错字符在整个字符串里的偏移,doc就是被解析的原文。拿异常对象截一小段出来看,比盯着一整行几MB的串找强:
try: data = json.loads(s) except json.JSONDecodeError as e: print(e.msg, e.lineno, e.colno, e.pos) print(repr(e.doc[max(0, e.pos-30):e.pos+30]))
不同位置指向不同毛病:Expecting ',' delimiter多半是对象里少了逗号或者多写了尾逗号;Expecting property name enclosed in double quotes是用了单引号或者Python字典直接str()出来的结果;Unterminated string starting at是字符串没闭合,常见于响应被截断;Extra data说明第一个JSON后面还跟着别的内容,比如两个JSON对象拼在一行、或者日志前缀。实测把e.doc按pos前后各截30个字符打印出来,几次定位都在十几秒内完成,比整段重贴到在线校验网站快。
命令行里不想写脚本就用python -m json.tool验,合法就格式化输出,不合法会连行号列号一起报出来;加--sort-keys还能把键排序,顺带看清结构。
echo '{"a":1}' | python -m json.tool
python -m json.tool resp.json
3、编码和几个容易忽略的来源
UTF-8带BOM的文件读进来,开头会多一个\ufeff,json.loads看到它就报Expecting value,位置正好是char 0。用open(path, encoding='utf-8-sig')读能直接把BOM吃掉;已经读成字符串了就lstrip('\ufeff')。这种在Windows上用记事本另存为UTF-8的json配置文件上最常见,之前踩过一次,文件用编辑器看完全正常。
还有几类:接口返回的是gzip内容但客户端没解压、把字节bytes直接丢给json.loads(3.6起才接受bytes、bytearray)、爬虫拿到的是JSONP回调包裹、或者字符串里混了不可见的控制字符。requests的resp.content是bytes,resp.text是str,别把前者直接丢进去。simplejson这类第三方库对尾逗号、NaN的容忍度和标准库不一样,同一个串换个库能过,不代表数据本身合规。
4、把校验放到入口,别等异常
解析前先判空、判状态码,再判首尾字符是不是{或[,挡掉八成的空body和HTML错误页。解析统一包一层try/except json.JSONDecodeError,把status_code、URL、e.msg、e.pos和原文前200字符一起记进日志,排查时不用再复现一次。日志里别把完整响应体打进去,含手机号、token的返回会被一并记下来。
Python 3.5.0、3.6.0、3.9.0、3.10.0、3.11.0、3.12.0、3.13.0、3.14.0,这些版本里JSONDecodeError的四个属性和报错文本格式都没变,2026年翻文档还是line、column、char那套写法;3.4及更早抛的是ValueError,没有pos这些属性,老项目里except ValueError仍然管用。手头几个脚本从3.8迁到3.12实测行为一致,数据截至2026年11月。
把repr()和status_code先看一眼,再决定改解析代码还是找上游,比盯着JSON本身较劲省事。