使用Azure Document Intelligence本地文件分析遇404错误求助

• 自定义模型状态与ID匹配问题

  • 确认模型ID对应的自定义模型处于Ready状态，训练失败或未完成的模型无法被调用。可在Azure控制台的Document Intelligence资源页面→「自定义模型」列表中查看状态。
  • 核对模型ID的准确性，注意大小写、连字符等细节，避免复制时出现字符缺失或多余。

• Endpoint配置错误

  • 确保Endpoint URL格式正确，应为https://{你的资源名称}.cognitiveservices.azure.com/，不要遗漏末尾斜杠，也无需额外添加/api这类路径（SDK会自动处理）。
  • 验证Endpoint所属区域与训练模型时的区域完全一致，跨区域调用自定义模型会直接返回404。

• SDK版本兼容性问题

  • 检查Azure.AI.FormRecognizer NuGet包版本，建议升级到最新稳定版。旧版本SDK可能不兼容新训练的自定义模型，尤其是v3.1及以后的API版本变动较大。
  • 确认模型训练时使用的API版本与当前SDK依赖的API版本匹配，跨版本调用可能引发资源找不到的错误。

• 本地文件流处理不当

  • 确保文件流的位置指针处于起始位置，如果之前读取过流内容，必须调用content.Position = 0;重置指针，否则SDK会读取空内容，触发异常。示例代码：

    using var content = new FileStream("local-document.pdf", FileMode.Open);
    // 重置流指针到起始位置
    content.Position = 0;
    var operation = await client.AnalyzeDocumentAsync(WaitUntil.Completed, modelId, content);
    

  • 确认上传的文件格式与模型训练时使用的文件类型一致（比如训练用PDF，当前也传PDF），虽然格式不匹配不一定直接返回404，但可能引发其他连锁异常。

• 资源权限与网络问题

  • 确认API Key所属的Document Intelligence资源与训练模型的资源是同一个，跨资源调用自定义模型需要额外配置权限，默认仅允许访问同一资源内的模型。
  • 检查内部服务器的网络配置，确保能正常访问Azure的Endpoint。防火墙或代理拦截可能导致请求无法到达服务端，部分情况下会伪装成404错误返回。

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