Forms Recognizer预览版无法加载示例文档问题咨询

我太懂你折腾Forms Recognizer预览版时的挫败感了——好不容易搞定SAS URL能读取文档，结果又卡在“文档无效或超出限制”的报错上，还怀念之前直接发文档内容训练的老方式，这确实让人头大。下面针对你的问题逐一拆解：

一、SAS URL的正确配置细节 #

你提到加了&comp=list&restype=container后能列出Blob但仍报错，说明基础的容器权限已经到位，但还有几个关键参数得盯紧：

• 权限与资源类型：生成SAS时必须选「容器」作为资源类型，同时勾选「读取」和「列出」权限——单个Blob的SAS没法满足模型训练时遍历容器文档的需求。
• 参数拼接要规范：正确的容器SAS URL格式应该是：

  https://<存储账户名>.blob.core.windows.net/<容器名>?<SAS令牌>&restype=container&comp=list
  

  别手动拼接时漏了?或者符号顺序错了，另外要确保过期时间expiry还在有效期内，隐性过期也会导致各种奇怪报错。

二、文档无效/大小限制报错的排查方向 #

哪怕SAS配置对了，还是报错的话，大概率是文档本身或容器环境的问题：

• 文档合规性检查：确认你的文档没有损坏，格式是预览版支持的（PDF、JPG、PNG等），页数也没超当前预览版的上限（比如部分版本单文档限200页，具体以当前预览规则为准）。
• 文件大小再确认：哪怕你觉得自定义表单符合限制，也再核对下是否超了预览版的单文件上限（通常是50MB，但预览版可能有调整）。
• 清理容器杂文件：如果容器里混了非支持格式的文件（比如临时缓存、TXT文档），Forms Recognizer遍历容器时会触发报错，建议把训练用文档单独放在一个干净的容器里。

三、关于REST负载发文档内容的替代方案 #

我完全理解你怀念旧版直接发文档内容训练的方式——确实更直观。不过在预览版里，虽然主推Blob存储批量训练，但单文档测试可以试试这个方法：

• 调用POST /formrecognizer/v2.1-preview.3/custom/models接口，在请求体里把文档内容转成base64编码发送，不用指定SAS URL。不过这种方式只适合单文档快速验证，批量训练还是得用Blob容器方案。

最后提醒下，预览版的参数和限制可能会随版本更新调整，建议多留意当前预览版的官方说明，避免用了旧版的配置思路踩坑。

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