[Bug]: falsy metadata values stored as None in Azure AI Search index

快速结论：这个 Bug 主要在使用 LlamaIndex 将节点（Node）写入 Azure AI Search 索引时触发，当元数据（metadata）包含 0、空字符串 ""、空列表 [] 等“假值”（falsy）时，这些值会被错误地存储为 None。优先排查 azureaisearch/base.py 中约第 899 行的条件判断。

问题场景

用户使用 LlamaIndex 的 Azure AI Search 向量存储（Vector Store）集成，通过 llama-index-vector-stores-azureaisearch 包操作索引。在向索引添加节点并设置元数据值为整数 0、空字符串或空列表后，从索引检索节点时发现这些值变成了 None。

报错原文

Falsy metadata values (0, "", []) are stored as None in Azure AI Search index.

Steps to Reproduce:
Create an Azure AI Search index with a metadata value that is an integer.
Add a node with metadata value = 0.
Retrieve the node from the index and the value is None instead of 0.

原因分析

问题出在 llama-index-integrations/vector_stores/llama-index-vector-stores-azureaisearch/llama_index/vector_stores/azureaisearch/base.py 文件的第 899 行附近。原始代码使用了 Python 的真值测试：

if metadata_value:

在 Python 中，0、空字符串 ""、空列表 [] 等都被视为假值，因此条件不成立，导致这些合法的元数据值被忽略或转换为 None。

环境排查

确认 LlamaIndex 版本：已知在 v0.4.0 中触发，建议确认当前版本是否包含此 Bug 或已修复。
检查 llama-index-vector-stores-azureaisearch 包的版本和安装来源。
查看 azureaisearch/base.py 文件中第 899 行附近的代码逻辑。

解决步骤

定位到文件 azureaisearch/base.py 中第 899 行附近，找到条件判断 if metadata_value:。
将判断改为显式的 None 检查：if metadata_value is not None:。
保存文件并重新运行索引写入操作。
（可选）为整数零元数据添加测试用例，确保修改后的逻辑正确处理所有假值。

验证方法

按照复现步骤重新创建 Azure AI Search 索引，添加包含元数据值 0 的节点，然后检索该节点。确认返回的元数据值为 0 而非 None。同时可测试空字符串 "" 和空列表 [] 的场景。

参考来源

run-llama/llama_index #21385

AI 工具推荐

想把多个 AI 模型放在一个入口？

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。

[Bug]: falsy metadata values stored as None in Azure AI Search index