讲师中心 微信公众号
AI工具推荐 视频效率加速

如何在Python异步接口中优雅地处理JSON解析异常?

雨敏酱_1665

雨敏酱_1665

发布时间:2026-07-17 06:55:01

|

741人浏览过

|

来源于php中文网

原创

应避免直接调用 response.json(),因其不校验状态码和 Content-Type,非法 JSON 或非 JSON 响应会抛出未捕获的 json.JSONDecodeError 导致协程崩溃;正确做法是先判状态码、再验 content_type,最后手动 text() + json.loads() 并包裹 try-except。

如何在python异步接口中优雅地处理json解析异常?

直接用 response.json() 会崩,别这么干

asyncio 环境下调用 response.json()(来自 aiohttp 或 httpx)看似方便,但一旦响应体不是合法 JSON,它会立刻抛出 json.JSONDecodeError,而且这个异常**不会被 asyncio 自动捕获或降级**——协程直接中断,上游 await 点崩溃,错误还可能被吞掉。更糟的是,很多 API 在 401/429/500 时返回 HTML 或纯文本,response.json() 完全不检查 Content-Type 或状态码,硬解析必挂。

aiohttp.ClientResponse.json() 的坑与替代写法

aiohttp 的 .json() 方法默认不校验响应头,也不处理空响应体。正确做法是手动读取 + 条件解析:

  • 先检查 response.status 是否在 200–299 范围,非成功状态优先用 await response.text() 提取错误信息
  • 再检查 response.content_type 是否为 "application/json",否则跳过解析
  • 用 await response.text() 获取字符串,再交给 json.loads() —— 这样你才能加 try-except

示例:

import json
import aiohttp

async def fetch_and_parse(url):
    async with aiohttp.ClientSession() as session:
        async with session.get(url) as resp:
            if not (200 <= resp.status < 300):
                return {"error": "HTTP error", "status": resp.status, "body": await resp.text()}
            if "application/json" not in resp.content_type:
                return {"error": "non-JSON content", "content_type": resp.content_type}
            try:
                return json.loads(await resp.text())
            except json.JSONDecodeError as e:
                return {"error": "invalid JSON", "pos": e.pos, "msg": e.msg}

异步场景下 json.loads() 的容错封装要点

同步封装的 safe_json_loads 直接搬进 async 函数里没问题,但要注意三件事:

python-script-generator
python-script-generator

快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构,支持CLI、API、爬虫、Bot、Django等多种项目类型,包含完整的项目结构、配置文件、依赖管理、测试、README和文档。

下载

立即学习“Python免费学习笔记(深入)”;

  • 输入必须是 str,不能是 bytes —— aiohttp 的 resp.read() 返回 bytes,得先 decode;resp.text() 已帮你做了,优先用它
  • 别在 try 块里做耗时操作(比如日志写磁盘),否则阻塞事件循环;错误信息建议只存内存或发到异步队列
  • 如果业务允许“部分容忍”,比如字段缺失可填默认值,就别在解析层兜底,而应在解析后用 dict.get("key", default) 处理,保持解析逻辑纯粹

大响应体 + 异步流式解析的边界在哪

当响应体超过几 MB,尤其是一次返回上千条记录的数组,await resp.text() 把整个响应加载进内存再 json.loads() 就危险了。这时候要换路子:

  • 确认格式:如果是 NDJSON(每行一个 JSON 对象),用 async for line in resp.content: 逐行解码 + json.loads(line.decode())
  • 如果是单一大数组([{...},{...}]),json.loads() 必须全量加载,没得选;真要流式,得上 ijson 配合 asyncio.to_thread() 把解析挪到线程池,但注意这会增加调度开销
  • 永远不要在协程里调 json.load()(文件 IO 版),它同步阻塞,等于给 event loop 打麻药

真正容易被忽略的,是 HTTP 响应流关闭时机 —— 如果你在解析中途出错并提前 return,记得确保 resp 被正确释放(aiohttp 通常自动处理,但自定义 connector 时得留心)。

热门AI工具

更多
Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

相关专题

更多
python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

1671

2023.07.20

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

4184

2023.07.25

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

1669

2023.07.31

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

24277

2023.08.03

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2967

2023.08.04

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

3007

2023.08.04

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

1163

2023.08.11

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

596

2023.08.10

FrankenPHP集成Laravel详细教程
FrankenPHP集成Laravel详细教程

本专题提供FrankenPHP集成Laravel的详细配置指南,全面解析运行原理、开发环境搭建、Caddyfile配置、Octane工作模式、数据库连接、队列任务、定时任务和生产环境优化,解决部署过程中常见的报错与兼容性问题。

0

2026.10.08

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn