如何解决Document Intelligence Layout 3.1容器返回JSON缺失语言数据问题

针对你遇到的Document Intelligence容器版语言检测结果为空、日志报错的问题，可按以下方向逐一排查：

1. 版本兼容性校验 #

• 确认azure-ai-formrecognizer 3.3.0与Layout 3.1容器的API版本匹配：SDK 3.3.0默认对应Document Intelligence API v3.1，但部分功能可能需要容器同步适配。可尝试升级容器至Layout 3.2或更高版本（与SDK 3.3.0兼容性更好），或降级SDK到3.2.0版本适配Layout 3.1容器。
• 调用接口时显式指定API版本：在begin_analyze_document中通过api_version参数指定"2022-08-31"（对应v3.1），避免SDK默认使用更高版本引发不兼容。

2. 容器计费配置检查 #

日志中的BillingInternalServerError表明容器无法正常与云端计费服务通信，这会限制语言检测等功能：

• 确认启动容器时已正确设置AZURE_BILLING_ENDPOINT、AZURE_API_KEY环境变量，密钥需对应容器部署的区域，且具备Document Intelligence权限。
• 检查容器所在网络是否能访问Azure计费端点，若使用代理需配置HTTP_PROXY/HTTPS_PROXY环境变量，确保容器可正常发起 outbound 请求。

3. PDF处理组件异常修复 #

日志中的TIFF格式错误是容器内部PDF转码逻辑异常导致的：

• 确保启动容器时已添加ACCEPT_EULA=y环境变量，未接受许可可能导致部分组件功能受限。
• 增加容器资源分配：将CPU配额提升至至少2核，内存提升至4GB以上，PDF处理需要足够资源，资源不足可能引发转码失败。
• 重新拉取容器镜像：若本地镜像损坏，执行docker pull mcr.microsoft.com/azure-cognitive-services/form-recognizer/layout:3.1重新获取镜像。

4. 接口调用参数验证 #

• 确认调用begin_analyze_document时使用的模型ID为"prebuilt-layout"，避免拼写错误。
• 检查传入的PDF文件完整性：本地文件可能存在损坏，可使用云端能正常处理的文件副本重新测试。

内容的提问来源于stack exchange，提问作者Ye Naing Oo