如何用Java将RedisSearch的FT.SEARCH结果解析为JSON/POJO？

1. 优先用Redis Java客户端的内置RedisSearch支持 #

别自己手动解析字符串，主流Java客户端都针对RedisSearch做了封装，直接用现成的结构化处理能力：

• 若使用Jedis：调用jedis.ftSearch()方法，它会返回SearchResult对象，包含匹配总数getTotalResults()，以及每个Document实例。每个Document可通过getProperties()拿到字段键值对，直接转成POJO或JSON：

SearchResult result = jedis.ftSearch("myIndex", "@name:John").get();
ObjectMapper mapper = new ObjectMapper();
for (Document doc : result.getDocuments()) {
    // 转成Map
    Map<String, String> fieldMap = doc.getProperties();
    // 映射为POJO
    User user = mapper.convertValue(fieldMap, User.class);
    // 转成JSON字符串
    String jsonStr = mapper.writeValueAsString(fieldMap);
}

• 若使用Lettuce：执行FT.SEARCH后会返回List<Object>，可直接遍历这个列表，按结果结构（总数→文档ID→字段名+值成对）拆分，再映射为结构化数据。

2. 手动解析原始结果（仅当必须处理字符串时） #

如果只能拿到原始字符串结果，别用正则或简单split，遵循FT.SEARCH的固定返回结构（总数→每个文档的ID+成对字段名/值）来处理：

// 假设rawResult是FT.SEARCH返回的原始字符串，格式类似"1\nuser:1\nname\nJohn\nage\n30"
String[] parts = rawResult.split("\n");
int total = Integer.parseInt(parts[0]);
List<User> userList = new ArrayList<>();
ObjectMapper mapper = new ObjectMapper();

for (int i = 1; i < parts.length; i += 2) {
    String docId = parts[i];
    String[] fieldPairs = parts[i+1].split("\n");
    Map<String, String> fieldMap = new HashMap<>();
    // 字段名和值交替出现，按成对方式存入Map
    for (int j = 0; j < fieldPairs.length; j += 2) {
        fieldMap.put(fieldPairs[j], fieldPairs[j+1]);
    }
    // 转成POJO
    User user = mapper.convertValue(fieldMap, User.class);
    userList.add(user);
}

这种方式比正则和split稳健，能避免字段值含特殊字符（如换行、冒号）时的解析错误。

3. Spring项目用Redis OM Spring（高级封装） #

如果是Spring技术栈，直接用Redis OM Spring，它能自动将RedisSearch结果映射为POJO，无需手动处理解析逻辑：

// 定义实体类，添加RedisSearch注解
@RedisHash("user")
public class User {
    @Id
    private String id;
    @Indexed
    private String name;
    private int age;
    // getter/setter
}

// 定义仓库接口
public interface UserRepository extends RedisDocumentRepository<User, String> {
    List<User> findByName(String name);
}

// 业务代码中直接调用，自动完成搜索和映射
List<User> users = userRepository.findByName("John");

为什么别用正则或split？ #

• Java正则虽无global标志，但可通过Matcher.find()循环实现全局匹配，但FT.SEARCH结果是嵌套结构，正则很难处理字段值含特殊字符的场景，极易出错。
• String.split依赖固定分隔符，若字段值包含分隔符（如换行），会直接破坏结果结构，完全不可靠。

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