如何处理Python中Json序列化时出现的TypeError: Object of type bytes is not serializable?

浅萱大大_8282

浅萱大大_8282

2026-07-22

895人浏览

原创

json.dumps() 报 bytes 不可序列化是因为 JSON 只支持 str、int、float、list、dict、bool 和 None;bytes 必须手动转为 hex() 或 base64 字符串,嵌套结构需递归处理或用 safe default 函数。

如何处理python中json序列化时出现的typeerror: object of type bytes is not serializable?

为什么 json.dumps() 会报 bytes 不可序列化?

因为 json 模块只认 Python 原生类型:str、int、float、list、dict、bool 和 None。bytes 不在其中,哪怕它只是个二进制字符串(比如从 hashlib.sha256().digest() 或 os.urandom(16) 生成),直接传给 json.dumps() 就会触发这个 TypeError。

最常用且安全的解决方式:预处理 bytes 字段

别指望 json 自动转换,得手动转成 JSON 可接受的表示形式。最通用的做法是用 .decode('utf-8')(仅当 bytes 确实是 UTF-8 编码文本)或更稳妥的 .hex() / base64.b64encode(...).decode('ascii'):

  • 如果 bytes 是文本(如 API 返回的原始响应体),先尝试 my_bytes.decode('utf-8');失败就说明不是文本,别硬 decode
  • 如果 bytes 是任意二进制数据(哈希值、密钥、加密结果),一律用 my_bytes.hex()(输出小写十六进制字符串)或 base64.b64encode(my_bytes).decode('ascii')
  • 不要用 str(my_bytes) —— 它会输出类似 b'\x01\x02' 的 repr 字符串,不是你想要的原始内容

遇到嵌套结构(如 dict/list 含 bytes)怎么办?

不能只改顶层变量,得递归处理。写个简单转换函数比每次手动调用更可靠:

def json_safe(obj):
    if isinstance(obj, bytes):
        return obj.hex()  # 或 base64.b64encode(obj).decode('ascii')
    elif isinstance(obj, dict):
        return {k: json_safe(v) for k, v in obj.items()}
    elif isinstance(obj, list):
        return [json_safe(v) for v in obj]
    else:
        return obj
<h1>使用</h1><p>data = {'key': b'', 'nested': {'id': b'abc'}}
json.dumps(json_safe(data))  # ✅ 正常输出</p>

注意:这个函数不处理 tuple、set 等非标准 JSON 类型,如有需要得额外分支判断。

Mailtrap Node.js SDK 用于事务性和沙盒电子邮件
Mailtrap Node.js SDK 用于事务性和沙盒电子邮件

一个基于官方 Mailtrap Node.js SDK 构建的 ASE 技能,用于发送事务邮件并与 Mailtrap 沙盒或生产流程协作。它非常适合需要 API 驱动邮件投递、测试邮箱验证和结构化消息自动化的代理工作流。

下载

能否用自定义 default 参数一劳永逸?

可以,但要小心副作用。传给 json.dumps(..., default=...) 的函数会在每个无法序列化的对象上调用:

json.dumps(data, default=lambda x: x.hex() if isinstance(x, bytes) else None)

问题在于:default 函数返回 None 时,json 仍会报错(因为 None 不是“可序列化”,而是没提供有效替代)。必须确保所有分支都返回 JSON 兼容类型:

  • 返回 x.hex() ✅
  • 返回 base64.b64encode(x).decode('ascii') ✅
  • 返回 None ❌(除非你确定该字段允许为空且前端能处理)
  • 抛异常或返回字符串描述(如 f"")——仅用于调试,别用于生产

真正容易被忽略的是:有些库(如 requests.Response.content)返回的就是 bytes,而你可能根本没意识到它藏在深层字典里。检查数据结构比硬套方案更重要。

Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!

相关专题

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

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

2023.07.20

1991

4

python能做什么
python能做什么

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

2023.07.25

5684

7

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

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

2023.07.31

1929

3

python教程
python教程

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

2023.08.03

34897

23

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

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

2023.08.04

4067

5

python eval
python eval

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

2023.08.04

4067

5

scratch和python区别
scratch和python区别

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

2023.08.11

1303

5

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

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

2023.08.10

636

4

python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

3163

5

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程