Azure Search索引器无法解码blob元数据metadata_title问题求助

以下是针对性的排查步骤：

• 核对字段映射的准确性
  仔细对比document_url和metadata_title的字段映射规则，确保拼写完全一致（比如有没有把metadata_title写成metadata-title或其他变体），映射表达式格式完全相同，比如都是base64Decode($blob/metadata_title)，没有多余的引号、转义字符或者拼接操作。

• 重置索引器并触发全量扫描
  Azure Search索引器可能会缓存旧的blob元数据，即使你删除了blob的metadata_title属性，缓存的旧值仍可能被读取。操作步骤：

  1. 在Azure Portal找到目标索引器
  2. 点击「重置」按钮清除缓存
  3. 选择「全量扫描」重新运行索引器，强制读取最新的blob元数据

• 适配URL-safe Base64的解码规则
  标准的base64Decode函数可能不支持URL-safe的Base64编码（即把+替换为-、/替换为_的格式）。如果metadata_title包含-或_，可以先转换为标准Base64再解码，修改映射表达式为：

  base64Decode(replace(replace($blob/metadata_title, '-', '+'), '_', '/'))
  

  而document_url可能刚好没有使用这些特殊替换字符，所以能正常解码。

• 查看索引器详细错误日志
  开启索引器的诊断日志（Azure Portal → 索引器 → 诊断设置 → 启用日志到Log Analytics），运行索引器后查看失败文档的具体输入值，确认传入base64Decode的参数是否真的是你预期的Base64字符串，有没有出现空值、额外空格或其他意外字符。

• 检查目标字段MetaTitle的约束
  对比MetaTitle和Url的字段定义，除了「可搜索」属性外，检查是否存在其他差异：比如MetaTitle是否设置了maxLength限制、是否启用了特定的分析器/标准化器，这些约束可能在解码后触发验证错误（不过当前报错是Base64无效，这个优先级较低，但可以排查排除）

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