根本原因是输入字符串不符合json语法规范:空或空白字符串触发“expecting value”错误;单引号、末尾逗号、bom、控制字符、html响应等均导致jsondecodeerror;须先strip、校验、清洗再解析。

json.loads() 抛出 JSONDecodeError,根本原因不是“它坏了”,而是你传给它的字符串不符合 JSON 语法规范——哪怕只差一个引号、一个逗号,或开头多了一个不可见的 BOM 字符。
为什么空字符串或空白字符串会触发 Expecting value: line 1 column 1 (char 0)
这是最常被忽略的“假空”问题:json.loads('') 或 json.loads('\n\t ') 都会报这个错。JSON 解析器在第一字符就找不到合法起始符号({、[、"、true、false、null 或数字),直接放弃。
- 检查前先用
.strip():如果来源是文件读取、API 响应或用户输入,务必先做text.strip()再传给json.loads() - 注意隐藏 BOM:Windows 记事本保存的 UTF-8 文件可能带
\ufeff,导致json.loads(content)失败;用content.lstrip('\ufeff')或更稳妥地用open(..., encoding='utf-8-sig')读文件 - 别依赖
if content::空格、换行、BOM 都会让content非空但无法解析
单引号、末尾逗号、JS 风格写法导致 Expecting property name enclosed in double quotes
Python 的 json 模块严格遵循 RFC 8259,只认双引号字符串、不允许末尾逗号、不支持 undefined 或注释——这些常见于前端调试输出或 JS 对象字面量,但不是 JSON。
- 典型非法内容:
{"name": 'Alice'}(单引号)、{"age": 25,}(末尾逗号)、{/* comment */ "ok": true} - 临时修复可用
ast.literal_eval()(仅限可信输入):它能安全解析 Python 字面量语法,比如ast.literal_eval("{'name': 'Alice'}")返回字典 - 生产环境推荐用
json5库替代:pip install json5,然后用json5.loads(text),它原生支持单引号、注释、末尾逗号等扩展语法
响应体不是 JSON 时的 Expecting ',' 或 Expecting object 错误
这类错误往往意味着你拿到的根本不是 JSON——比如 HTTP 404 页面返回了 HTML,或后端出错返回了 traceback 文本,而你直接拿 response.text 去解析。
- 永远先检查
response.status_code == 200,再检查response.headers.get('content-type', '').startswith('application/json') - 打印前 200 字符看真实内容:
print(repr(response.text[:200])),比盲目改格式更高效 - 网络请求中避免裸用
json.loads(response.text):应封装成带状态和类型校验的函数,否则一次 502 就让整个流程崩掉
文件读取时的编码与换行符干扰
用 json.load() 读文件出错,90% 是编码或换行符惹的祸,而不是 JSON 本身有问题。
- 别省略
encoding='utf-8':默认编码在不同系统上可能不同,Linux 下可能是 utf-8,Windows 下可能是 cp1252,导致中文乱码进而解析失败 - Windows 换行符
\r\n本身不影响 JSON,但若文件混用了\r(旧 Mac 风格)或有非法控制字符(如\x00),json.load()会直接报错 - 安全做法:先用二进制模式读,清洗后再解码:
with open('data.json', 'rb') as f: raw = f.read().replace(b'\x00', b''); text = raw.decode('utf-8')
真正难处理的从来不是语法错误,而是那些“看起来像 JSON 却不是 JSON”的边界情况——比如 API 文档说返回 JSON,结果偶发返回一段纯文本错误说明;或者日志里截断了一半的 JSON 字符串。这时候加一层 try/except json.JSONDecodeError 不是补救,而是必要防御。别假设输入干净,永远验证、清洗、再解析。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











