对象存入Redis为何报错_转JSON字符串再调用set方法

陌浩君_6172

陌浩君_6172

2026-04-06

487人浏览

原创

redis set命令只支持字符串值,存对象需先序列化为json;注意处理日期、枚举等特殊字段,避免额外引号,跨语言场景优先选json而非java原生序列化。

对象存入redis为何报错_转json字符串再调用set方法

Redis set 方法不支持直接存对象

Redis 的 set 命令底层只接受字符串类型(string)作为值,传入 Java 对象、Python 字典、Go struct 等原生对象会触发序列化异常或类型错误。这不是 Redis 客户端的 bug,而是协议层硬性限制——服务端根本不认识“对象”这个概念。

常见报错现象包括:WRONGTYPE Operation against a key holding the wrong kind of value(如果 key 之前存过其他类型)、java.lang.ClassCastException(Jedis/Lettuce)、TypeError: Object of type XXX is not JSON serializable(Python redis-py)。

  • 必须先将对象转成字符串,再调用 set
  • 推荐用 JSON 序列化,因其跨语言、可读性强、客户端普遍支持
  • 注意空值、循环引用、时间类型等特殊字段,JSON 库默认可能不处理

JSON 序列化时容易漏掉的三类字段

不是所有对象都能无损转成 JSON。比如 Java 的 LocalDateTime、Python 的 datetime、自定义枚举、含有 private 字段但没 getter 的 POJO,都会在序列化时报错或丢数据。

  • Java(Jackson):需注册 JavaTimeModule 处理日期,或用 @JsonFormat 注解
  • Python(json.dumps):传入 default 参数,例如 lambda o: o.isoformat() if isinstance(o, datetime) else str(o)
  • Go(encoding/json):结构体字段必须首字母大写(exported),且加 json: tag 控制键名和忽略空值

示例(Python):

import json
from datetime import datetime
<p>data = {"name": "alice", "created": datetime.now()}</p><h1>❌ 报错:TypeError: Object of type datetime is not JSON serializable</h1><h1>json.dumps(data)</h1><h1>✅ 正确处理</h1><p>json_str = json.dumps(data, default=lambda o: o.isoformat() if hasattr(o, 'isoformat') else str(o))
redis_client.set("user:1", json_str)</p>

set 时要不要手动加引号?JSON 字符串本身已含双引号

不需要,也绝不能额外包裹引号。JSON 序列化结果已经是合法字符串字面量,比如 {"name":"alice","age":25} —— 这本身就是字符串内容,不是代码语法里的字面量。

  • ❌ 错误写法:redis.set("key", '"' + json.dumps(obj) + '"') → 存进去的是 "{"name":"alice"}"(开头结尾多了一对引号)
  • ✅ 正确写法:redis.set("key", json.dumps(obj))
  • 验证方式:用 redis-cli get key 查看原始返回,应为纯 JSON 文本,无额外引号

性能与兼容性:为什么不用 Java 的 ObjectOutputStream?

虽然 Java 可以用 ObjectOutputStream 序列化对象为 byte[] 再存 Redis,但实际项目中几乎没人这么干。

  • 无法跨语言:PHP/Node.js 客户端读不出 Java 二进制格式
  • 版本脆弱:类结构一改(增删字段、改包名),反序列化直接失败
  • 体积更大:Java 序列化包含类名、字段描述等元信息,JSON 更紧凑
  • 调试困难:Redis CLI 里看到一堆不可读字节,排查问题只能靠猜

真正需要高性能且同构环境(全 Java)的场景,可考虑 Kryo 或 FST,但仍建议优先走 JSON + 显式 DTO 转换,把序列化逻辑收口、可控、可测。

复杂点往往不在“怎么存”,而在于“谁负责序列化、谁负责反序列化、字段变更时如何平滑过渡”。JSON 至少让这个问题暴露得早、看得见。

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2023.08.07

2035

5

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.23

2962

1

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

2023.10.13

1016

3

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

2025.09.10

3359

7

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.02

5759

3

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.03

1638

5

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.04

2444

5

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

2023.10.24

5924

49

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

2023.11.24

5229

6

热门下载

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

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.6万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 133.4万人学习