字段为空先不要改查询写法，也不要去换数据源。返回体结构正常但字段没值，通常是三处中的一处：请求里带了写死的过滤条件、查询语句的粒度或字段要求和索引里存的形态对不上、或者该领域本身没有被索引覆盖。可以先做一次确定能命中的基线查询，确认链路通；再逐项改查询语句看字段是否变化；最后换几个同类领域查一遍，看空是普遍的还是只在某类内容上出现。三段收缩下来，改查询还是换数据源就有依据了，不用猜。

字段为空时，先用确定能命中的词做基线查询排除链路问题，再逐项改关键词、查询粒度、字段要求看字段是否回填，然后核对请求参数里有没有写死的时间范围、类型过滤、字段白名单。如果只有特定领域为空、其他领域字段正常回填，通常指向索引覆盖范围而不是查询写法；改动前先把当前参数和返回结构留档，避免把覆盖问题误判成语句问题反复重写。

用确定能命中的词做基线查询

这一步只解决一个问题：这条链路是否能把索引里的字段带回来。选一个你确信库里有大量内容的常见词，参数放到最宽——不加时间范围、不加类型过滤、字段要求给默认或全量，条数限制给小一点便于逐条看。请求骨架如下，替换成你自己的接口地址和鉴权：

POST /anysearch/query
{
  "q": "基线词",
  "top_k": 3,
  "filters": {},
  "fields": ["id", "title", "content", "source", "updated_at"]
}

拿到返回后记三件事：total 或返回条数是多少；每条记录里 title、content、source 这些字段是 null、空字符串，还是键根本不存在；updated_at 这类时间字段有没有值。键不存在通常意味着索引里没建这个字段，空字符串或 null 意味着建了但这条记录没写入。两种情况的处理方向不同，先分清再动手。

逐项改查询语句看字段变化

基线查询字段正常回填后，把你原来那条查不出字段的语句拿出来，只改一项，其余保持不动，每次记录返回对比。三项分别试：

• 关键词：把宽泛的近义词换成更具体的实体词，或者在原词后加上限定词，看命中条数和字段填充是否变化。
• 查询粒度：从整句自然语言改成短句或关键词组合，看是否因为长句被切碎导致什么都没匹配上。
• 字段要求：把要求多个字段同时非空的写法拆开，先只要求一个字段，确认能回填后再逐步加回。

对比表按下面的列记录，每改一项填一行：

改动项 | 查询语句 | 返回条数 | 有空值的字段 | 是否出现新字段

如果只有某一项改动后字段开始回填，问题就在查询写法上，按能回填的那个版本收敛即可；如果三项全改完字段依旧为空，而基线查询是通的，就别再调语句了，往下看参数和覆盖范围。

检查请求参数里有没有写死的过滤条件

请求参数层的自我限制最容易被忽略，因为返回体结构完全正常，只是结果被自己筛空了。把当前请求的全部参数和取值逐条列出来，包括默认值：

q=...
top_k=10
filters.time_range=(待确认)
filters.lang=(待确认)
filters.doc_type=(待确认)
filters.source=(待确认)
fields=[...]
min_score=(待确认)

标出所有可能收窄结果范围的项：时间范围是不是被硬编码成了某个固定区间、语言或地区是否限死、doc_type 是否只留了一种、source 是否指定了某个来源、相似度阈值是否设得过高、fields 里是否列了索引里不存在的字段名。逐项置空或放宽后重发同一条查询，看条数有没有回升。这一步不需要改查询语句，只改参数，能最快排除掉一类假问题。

换同类查询看是否只在特定领域为空

挑三到五个不同领域的查询，用同一套参数、同一套字段要求跑一遍，记录字段填充情况。表格列可以这样设，值按你实际观察填：

领域   | 查询词 | 返回条数 | title有值 | content有值 | source有值
通用常识 |        |          |           |             |
产品文档 |        |          |           |             |
新闻资讯 |        |          |           |             |
内部工单 |        |          |           |             |
代码示例 |        |          |           |             |

判断规则很直接：多数领域字段都能回填、只有一两类领域为空，说明是索引没覆盖到那部分内容，换查询写法帮助有限，应该调整数据接入或接受该领域返回空；所有领域字段都空而基线查询正常，说明是那套参数或字段要求本身有问题，继续回到参数和语句上查。这里只描述你能观测到的返回差异，不要凭印象断定某个领域一定被收录或一定没有。

把空结果写成显式分支

不管最后定位到哪一层，调用侧都要给空字段一个明确出口，不能让模型对着空字符串自由发挥。建议在拿到返回后先做校验再决定后续动作：

def handle(resp):
    hits = resp.get("hits") or []
    usable = [h for h in hits if (h.get("content") or "").strip()]
    if not usable:
        return {
            "ok": False,
            "reason": "empty_fields",
            "retry": False,
            "message": "检索到 {0} 条记录，但没有可用正文，请补充关键词或确认该范围是否有数据".format(len(hits)),
            "degraded": True
        }
    return {"ok": True, "items": usable}

几个约定建议固定下来：空字段时返回固定文案，说明检索到了几条但字段为空，不要拼接模型生成的内容；是否重试要看空的原因是参数被收窄还是覆盖不到位，前者可以放宽参数重试一次，后者重试通常没有意义，默认不重试；给调用方留一个标记字段，比如空字段用 empty_fields、条数为零用 no_hits、被降级用 degraded，让上层能区分“没搜到”和“搜到了但没内容”，这两种情况的后续处理不一样。改完之后用之前那条查不出字段的语句再跑一遍，确认返回的是显式分支而不是一段看似合理的编造内容。