如何在Redis终端正确设置Java存储的Map类型哈希字段值

你遇到的ClassCastException是两个操作误区叠加导致的：

1. 不熟悉Redis-cli的参数解析规则：Redis-cli会自动按空格拆分命令参数，如果要存储的JSON值本身包含空格、特殊字符，必须把整个值用外层引号包裹成单个独立参数，否则命令逻辑会完全偏离预期。
2. 手动写入的内容格式和Java客户端的反序列化逻辑不匹配：你Java代码里的Redis客户端，存储Map类型值时会按预设的序列化规则（从你hget能读到可读JSON的表现判断，用的是Jackson类的JSON序列化器）生成固定格式的字节流，如果手动写入的内容不符合这个格式要求，客户端反序列化时会直接返回原始字符串，无法转成Map类型，最终触发类型转换异常。

你之前执行的未加引号的命令：
hset key field {"one":10, "two",20}
在Redis-cli里实际会被拆成多个独立参数，最终执行效果和预期完全不同：

• 给field字段写入的值只是JSON的残片{"one":10,
• 后续的"two",20}会被当成Hash结构里的一个新字段名，没有对应合法值
• 加上你写的JSON本身存在语法错误（"two"后面错把冒号写成了逗号），Java客户端解析时根本无法把这段内容还原成Map，只能把原始字符串返回，就抛出了String cannot be cast to java.util.Map的异常。

结合你当前的存储场景（Java客户端将Map序列化为JSON字符串，存在单个Hash字段下），按照以下步骤操作即可：

1. 写Redis-cli命令时，必须用单引号把整个JSON值包裹为单个参数，避免被JSON内部的空格拆分成多个命令参数
2. 保证JSON本身语法完全正确，不要把冒号、逗号写错
3. 正确的命令格式如下：

   hset key field '{"one":10, "two":20}'
   

4. 写完后可以先执行hget key field验证返回值，确认是完整、无语法错误的标准JSON串后，再用Java程序读取测试。

额外注意：如果你的Java客户端是把传入的Map直接拆成Redis原生Hash的独立字段存储（也就是不存在单个field存整个Map的逻辑），那你需要改用hset key one 10 two 20的命令，直接把Map的每个键值对作为Hash的独立字段写入，而不是把整个JSON字符串塞到某个字段里。

内容的提问来源于stack exchange，提问作者lily