Azure文档智能已知问题和故障排除

Azure文档智能持续更新,服务更改可能会影响功能行为和功能限制。 本文跟踪Azure文档智能中的已知问题,介绍其影响,并提供缓解或解决指南。 在提交支持请求之前,请查看列表以确定问题是否为已知条件并识别建议的修正。

服务级别中断和通知

Azure状态并Azure 服务运行状况发布服务级别中断和区域性中断。 使用这些服务验证当前影响、跟踪事件生命周期更新,以及为订阅和资源配置主动通知。

当前已知问题

下表列出了Azure文档智能中的活动、服务确认的问题。 每个条目包括问题类别、观察到的行为、记录的解决方法和初始发布日期。

问题编号 类别 Title 说明 Workaround 发布日期
2006 模型准确度 当单个页面包含不同方向的表时,表识别失败 当前管道为每个图像或页面生成单个统一旋转角度,并将其应用于所有检测到的表。 不支持同一页中的多个表格方向。 由于布局是识别管道中的第一个阶段,因此自定义模型不会缓解此限制。 受影响的模型: 所有模型(布局阶段限制)。 在提交前预处理文档:检测每个表区域的主导方向(例如,通过检查 PDF 内容流旋转值或应用图像分析旋转检测),将页面拆分为单独的图像(每个不同方向一个),并作为独立的分析请求提交每个图像。 在应用程序层中合并结构化结果。 2026 年 6 月
2005 模型准确度 单行表的表提取缺失行 单行构造在当前设计中不归类为表。 当源文档将表定义为单个行时,提取输出中可能缺少行。 此行为是设计提供的,可以在将来的版本中进行优化。 受影响的模型: 所有模型。 单行表内容显示在“分析”响应的数组中 paragraphs , keyValuePairs 而不是 tables 数组中。 使用这些数组并检索内容。 或者,使用或boundingRegions数组中的wordslines多边形坐标以编程方式在后期处理中重新构造行结构。 2026 年 6 月
2004 模型准确度 OCR 字符歧义:1 与 l 和 O 与 0 视觉上不明确的字符对(1/l 和 O/0)可以错误分类,尤其是在缺少语义上下文的序列号类似字段中。 该模型应用语言上下文来提高自然语言字符串(例如更正为6OO或600更正App1e)Apple的准确性,但这种启发式对字母数字标识符无效。 受影响的模型: 所有模型。 对提取 content 的值应用特定于字段的后处理验证。 对于序列号或标识符字段,请对预期的字符集使用正则表达式或字符允许列表检查,并应用替换规则(其中 1/l 或 O/0 混淆是域可预测的)。 此外,检查数组中的confidence每字words分数,以确定低置信度跨度,并确定目标人工评审或自动更正的优先级。 2026 年 6 月
2003 模型准确度 OCR 无法检测上标格式 上标格式字符不识别为上标。 它们被提取为普通内联文本,没有位置或格式差异。 受影响的模型: 所有模型。 没有可用的模型级解决方法;上标检测是自定义模型训练无法解决的 OCR 阶段限制。 作为后处理替代方法,请在 Analyze 响应中比较polygon对象中boundingBox相邻word跨度或line坐标。 垂直基线相对于同一行中周围单词显著提升的字词,可以在应用程序中识别为可能的上标和标记或批注。 2026 年 6 月
2002 模型准确度 短划线 (-) 字符错误识别或返回为“1” 间歇性模型质量问题导致短划线(-)字符被错误识别或返回为数字 1。 受影响的模型: 所有模型。 没有可用的模型级解决方法;此问题是自定义模型训练无法解决的 OCR 阶段错误认知。 对短划线为有效值或预期值的字段应用后处理验证:使用正则表达式或位置启发法识别在分隔符或 null 值位置中显示的独立 1 字符(例如,在字母数字标记或固定宽度结构化字段中),并用短划线替换它们。 使用每字 confidence 分数确定提取需要更正的优先级。 2026 年 6 月
2001 模型准确度 不支持嵌套表结构 文档智能预生成的布局模型不支持嵌套表。 仅提取最外部的表结构;内部嵌套表无法识别为离散表对象。 受影响的模型: 所有模型。 自定义提取模型和内容理解分析器使用布局模型作为其第一个处理阶段,因此自定义训练不会解析嵌套表检测。 作为后处理替代方法,请使用 boundingRegion “分析”响应中为每个检测到 table 的和 cell 对象返回的多边形坐标,以识别空间上包含另一个检测到表的边界多边形的单元格区域。 使用此重叠在应用程序中以编程方式重新构造父子嵌套关系。 2026 年 6 月
1005 模型训练 模型训练停滞在 “未启动 ”状态 如果在执行之前模型训练作业失败,则失败的作业可能会在状态 为“未启动”的模型列表中保持可见。 此状态由后端生命周期处理而不是客户配置导致。 大约七(7)天后,后端会自动清除失败的训练作业。

如果需要提前删除,请提交 Azure 门户支持请求。 CSS 或 PG 工程可以执行孤立训练记录的后端删除。
2026 年 4 月
1004 模型训练 HTTP 500 – 模型训练期间的内部ServerError (神经或模板、预览/GA API) 模型训练可能失败, HTTP 500 / InternalServerError。 在资源上未正确配置托管标识(尤其是在较新的训练流中)时,通常会发生此故障。 在文档智能资源上启用 托管标识 。

验证标识是否具有所需的权限。

遵循官方 托管标识配置指南。
2026 年 4 月
1003 模型管理 复制模型时出现模型存在错误 复制自定义模型可能会失败,并出现 “模型存在 ”错误。 当目标资源上保留损坏或部分创建的模型时,将发生此错误。 客户无法自行解决此条件。 没有可用的客户端解决方法。

提交 支持请求 ,以便产品组可以从后端删除损坏的模型。
2026 年 4 月
1002 Encryption 使用 CMK 时出现 ServiceUnavailable 错误 依赖于 客户管理的密钥(CMK) 的操作可能会间歇性失败,出现 服务不可用 错误。 当存储服务使用过时的缓存标识或密钥材料时,将发生此故障。 选项 A:CMK刷新缓存。 禁用并重新启用 CMK、分配新密钥或关联新的托管标识。

Option B: 切换到 Microsoft 托管密钥(MMK):在 Azure 门户中导航到文档智能资源。 资源管理→加密→Microsoft托管密钥。
2026 年 4 月
1001 文件类型 Excel文件不支持内容错误 Excel文件记录为受支持的输入类型。 当文件内容超出内部字符限制时,不支持请求失败,内容不受 支持 。 这种情况通常发生在大量或密集填充的电子表格中。 Excel大于 ~8,000,000 个字符的文件被拒绝。

将大型Excel文件拆分为较小的文件,并单独提交它们。
2026 年 4 月