Azure Cognitive Search服务索引器无法创建的问题求助

• 检查操作返回的错误细节

  • 用REST API创建时，务必捕获完整的响应状态码和响应体，比如403可能是权限问题，400可能是索引器定义有语法/配置错误（比如数据源连接字符串无效、目标索引字段不匹配）
  • 门户UI操作时，打开浏览器开发者工具（F12），查看Network标签下的请求响应，找隐藏的错误提示

• 验证权限配置

  • 确认当前账号拥有Search Indexer Contributor或更高权限（比如Search Service Contributor），哪怕之前有权限，也可能因RBAC角色变更失效
  • 设备代码认证后，检查获取的令牌权限范围，确保包含https://search.azure.com/.default的API权限

• 排查索引器定义的合法性

  • 核对数据源类型（Blob Storage、SQL DB等）的配置：连接字符串是否过期、容器/表名是否存在、是否开启了必要权限（比如Blob存储的读取权限）
  • 确认目标索引的字段与数据源映射匹配，别出现数据源有但索引未定义的字段，或者字段类型不兼容的情况
  • 检查索引器的调度、字段映射、技能集（如果用了）的语法，确保JSON格式合规

• 检查服务限制

  • 确认Azure Cognitive Search服务的索引器数量是否达配额上限，不同层级服务配额不同（比如免费层最多3个）
  • 查看搜索服务概览页的"服务健康"状态，确认服务没处于异常

• 核对资源组与服务的关联

  • 新建资源组后，创建索引器时选对搜索服务实例，别误操作到其他服务
  • 检查资源组的锁配置，有没有"删除锁"或"只读锁"导致无法创建资源

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