redis 存储序列化的对象错误 ERR Protocol error: expected '$', got ' '

问题解析

报错信息 redis.clients.jedis.exceptions.JedisDataException: ERR Protocol error: expected '$', got ' ' 表明 Redis 在处理客户端请求时，协议解析出现了问题。Redis 使用 RESP（REdis Serialization Protocol）协议进行通信，该协议要求数据格式严格符合规范。此错误通常是因为客户端发送的命令或数据不符合 RESP 协议的预期格式。

可能原因及解决方法

1. 命令格式错误

• 原因：客户端发送的命令未按照 RESP 协议的要求正确编码。例如，批量操作时未正确使用多行格式。
• 解决方法：
  • 检查客户端代码中发送的命令是否符合 RESP 协议规范。
  • 如果使用了自定义脚本或工具生成命令，请确保其输出格式正确。
  • 示例：对于批量操作，应使用如下格式：

    *3\r\n$3\r\nSET\r\n$3\r\nkey\r\n$5\r\nvalue\r\n
    

2. AOF 文件导入问题

• 原因：如果通过 AOF 文件导入数据，文件内容可能包含不兼容的格式或损坏的数据。
• 解决方法：
  • 确保 AOF 文件是通过 Redis 的 BGREWRITEAOF 或 CONFIG SET appendonly yes 命令生成的。
  • 检查 AOF 文件是否被修改过，或者是否包含非标准的 RESP 数据。
  • 如果 AOF 文件中启用了 RDB 前置格式（aof-use-rdb-preamble），需要将其关闭并重新生成 AOF 文件：

    CONFIG SET aof-use-rdb-preamble no
    BGREWRITEAOF
    

3. 客户端库版本不匹配

• 原因：使用的 Jedis 客户端版本与 Redis 服务器版本不兼容，导致协议解析失败。
• 解决方法：
  • 确保 Jedis 客户端版本与 Redis 服务器版本兼容。
  • 更新 Jedis 客户端到最新版本，以支持最新的 RESP 协议特性。

4. 网络传输问题

• 原因：在网络传输过程中，数据包可能被截断或损坏，导致 Redis 收到不完整的命令。
• 解决方法：
  • 检查网络连接是否稳定，避免高延迟或丢包。
  • 如果使用代理或负载均衡器，确保其不会对 Redis 协议数据进行修改。

5. Lua 脚本执行问题

• 原因：如果使用 Lua 脚本执行命令，脚本中可能存在不符合 RESP 协议的输出。
• 解决方法：
  • 检查 Lua 脚本的输出是否符合 RESP 协议。
  • 确保脚本中未直接返回空格或其他非法字符。

排查步骤

1. 查看日志：

   • 检查 Redis 服务器日志，确认是否有其他相关错误信息。
   • 查看客户端日志，定位发送的具体命令。

2. 验证命令格式：

   • 使用 redis-cli 手动执行相同的命令，验证其是否能够成功执行。
   • 示例：

     redis-cli -h <host> -p <port> -a <password> SET key value
     

3. 检查 AOF 文件：

   • 如果涉及 AOF 文件导入，使用以下命令检查文件内容：

     redis-check-aof --fix appendonly.aof
     

4. 更新客户端和服务器：

   • 确保 Jedis 客户端和 Redis 服务器均为最新版本。

重要提醒

• 加粗提示：在排查问题时，请优先检查客户端发送的命令格式是否符合 RESP 协议规范。
• 如果问题仍然无法解决，建议联系阿里云技术支持，提供详细的日志和上下文信息以便进一步分析。

通过上述步骤，您应该能够定位并解决 ERR Protocol error: expected '$', got ' ' 的问题。