RedisSearch-php文档搜索问题：查询返回空数组求排查

刚上手RedisSearch-PHP踩这个坑太正常了，咱们一步步拆解问题，找到根源：

1. 最可能的核心问题：索引字段类型未正确配置 #

你搜索不到内容的大概率原因是：创建bookIndex时，没有把title字段定义为可全文搜索的TextField类型。如果title被设成了TagField、NumericField，或者根本没在索引里定义这个字段，RedisSearch不会对它做全文索引，自然搜不到匹配内容。

正确的索引创建代码应该是这样的（确保title是TextField）：

use Ehann\RedisRaw\RedisClient;
use Ehann\RedisSearch\Index;
use Ehann\RedisSearch\Fields\TextField;
use Ehann\RedisSearch\Fields\NumericField;

$client = new RedisClient();
// 创建包含可搜索文本字段的索引
$bookIndex = new Index($client, 'books');
$bookIndex->addTextField('title')
          ->addTextField('author')
          ->addNumericField('price')
          ->addNumericField('stock')
          ->create();

2. 先确认文档是否真的添加成功 #

有时候看起来代码执行了，但文档其实没被写入RedisSearch。可以在添加文档后立刻检查返回结果：

$addResult = $bookIndex->add($document);
var_dump($addResult);

如果返回true说明添加成功；如果是false，可能是索引不存在、字段不匹配（比如你添加了索引里没定义的字段），这时候需要先修正索引结构。

3. 明确搜索字段（可选但更稳妥） #

如果不想依赖默认的全局搜索，可以明确指定搜索title字段，避免其他字段干扰：

// 精准搜索title字段中的"How"
$count = $bookIndex->search('@title:How')->getCount();

修正后的完整可运行示例 #

把这些要点整合起来，完整的工作代码如下：

use Ehann\RedisRaw\RedisClient;
use Ehann\RedisSearch\Index;
use Ehann\RedisSearch\Fields\TextField;
use Ehann\RedisSearch\Fields\NumericField;

// 初始化Redis客户端
$client = new RedisClient();

// 先删除旧索引（如果之前创建过错误结构的索引）
$bookIndex = new Index($client, 'books');
$bookIndex->drop();

// 创建正确的索引结构
$bookIndex->addTextField('title')
          ->addTextField('author')
          ->addNumericField('price')
          ->addNumericField('stock')
          ->create();

// 创建并添加文档
$document = $bookIndex->makeDocument();
$document->title->setValue('How to be awesome.');
$document->author->setValue('Jack');
$document->price->setValue(9.99);
$document->stock->setValue(9);
$bookIndex->add($document);

// 执行搜索并输出计数
echo $bookIndex->search('How')->getCount(); // 应该返回1

额外小提示 #

• RedisSearch默认是不区分大小写搜索的，所以不用纠结关键词的大小写问题，除非你手动给字段设置了caseSensitive(true)。

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