Azure Document Intelligence Studio自定义分类模型上传卡顿求助

问题概述 #

使用Azure Document Intelligence Studio免费版的自定义分类模型时，文档上传流程卡顿无进展，但文件已成功存入Azure Blob Storage，且无报错日志。

已执行排查动作 #

• 重启Document Intelligence Studio
• 验证Blob Storage连接有效性
• 检查Azure平台日志
• 尝试上传小尺寸文档

补充排查与解决建议 #

1. 免费版配额核查 #

免费版Document Intelligence存在调用次数、并发数等资源限制，即便文件成功写入Blob，后续分类预处理环节可能因配额耗尽被限流。前往Azure门户的Document Intelligence资源→使用情况+配额页面，查看当前配额使用状态，确认是否触及上限。

2. Blob Storage权限与配置校验 #

• 确认Blob容器访问级别：若为私有容器，需确保Document Intelligence服务的托管标识拥有Storage Blob Data Contributor权限，而非仅基础读取权限。
• 检查文件命名：避免使用#、?、/等特殊字符，此类字符可能引发Studio读取文件时的隐性阻塞。

3. 浏览器与网络环境调整 #

• 更换Chrome、Edge等主流浏览器，清除浏览器缓存后重新操作，缓存冲突可能导致前端界面卡顿。
• 排查代理或防火墙拦截：Document Intelligence Studio需访问*.cognitiveservices.azure.com类Azure端点，确保网络允许此类出站连接。

4. 模型与文档格式验证 #

• 确认自定义分类模型已完成训练且状态为就绪，未训练完成的模型无法处理分类请求。
• 转换文档格式：免费版对加密PDF、多层嵌入文档等复杂格式支持有限，尝试将文档转为标准PDF或JPG格式后再测试上传。

5. 后台任务状态核查 #

文件存入Blob后，Document Intelligence的处理任务可能处于后台队列等待。前往Azure门户的Document Intelligence资源→活动日志，查找DocumentClassification相关任务状态，确认是否存在排队或隐性失败情况（部分失败可能不会在Studio日志中显示）。

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