Document Intelligence调用404错误：美国中南部资源端点问题排查

问题背景 #

我们部署了3个Microsoft Document Intelligence资源，仅美国中北部资源调用正常，两个美国中南部资源均返回404 Resource not found错误：

• 美国中北部：密钥为无短横线GUID格式，端点https://[resource name].cognitiveservices.azure.com/，调用预构建布局模型（Base64内容方式）正常
• 美国中南部（通过Document Intelligence Studio创建）：端点https://southcentralus.api.cognitive.microsoft.com/，调用报错404
• 美国中南部（手动创建）：密钥为84字符，端点https://[resource name].cognitiveservices.azure.com/，同样报错404

已按微软迁移指南替换为最新DocumentIntelligenceClient，代码逻辑无问题，需排查区域、端点配置或客户端适配问题。

排查步骤 #

1. 确认美国中南部区域服务状态 #

登录Azure门户，进入服务健康面板，查看美国中南部（South Central US）区域的Document Intelligence服务是否存在故障、维护或部署延迟通知。部分新创建的资源可能因区域部署同步问题，无法立即响应请求。

2. 校验端点与密钥的匹配性 #

Studio创建的聚合资源

Studio创建的资源属于旧版通用认知服务聚合资源，需注意：

• 必须使用完整资源密钥（而非短密钥）
• 需显式指定该资源支持的API版本，DocumentIntelligenceClient默认的最新版本可能与旧聚合资源不兼容，示例配置：

var client = new DocumentIntelligenceClient(
    new ApiKeyCredential("your-full-key"),
    new DocumentIntelligenceClientOptions { ApiVersion = "2023-07-31" }
);
client.Endpoint = "https://southcentralus.api.cognitive.microsoft.com/";

手动创建的独立资源

手动创建的独立Document Intelligence资源需确认：

• 端点末尾的斜杠是否正确（SDK通常会自动处理，但部分场景下缺失会导致路由错误）
• 密钥是从Azure门户密钥和端点页面复制的完整84字符密钥
• 资源类型为Document Intelligence（而非通用认知服务资源），避免资源类型不匹配导致路由失效

3. 验证API版本与区域兼容性 #

不同区域对Document Intelligence的API版本支持可能存在差异，美国中北部作为成熟区域覆盖所有版本，而美国中南部可能存在版本部署延迟：

• 确认该区域支持的API版本（可通过Azure门户资源的文档链接查看）
• 尝试降级至稳定版API（如2023-07-31）测试，排除新版本未在该区域完全部署的问题

4. 绕过SDK直接测试REST API #

用curl或Postman直接调用REST API，验证资源本身是否正常：

curl -X POST "https://[your-resource-name].cognitiveservices.azure.com/documentintelligence/documentModels/prebuilt-layout:analyze?api-version=2023-07-31" \
-H "Content-Type: application/json" \
-H "Ocp-Apim-Subscription-Key: your-84-character-key" \
-d "{\"base64Source\": \"your-base64-document-content\"}"

如果REST调用仍返回404，说明问题出在资源配置或区域服务；如果REST调用正常，则排查DocumentIntelligenceClient的配置（如代理、端点拼接错误等）。

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