Postman访问Azure认知服务Form Recognizer v2.1接口返回404错误求助

你遇到的调用https://australiaeast.api.cognitive.microsoft.com/formrecognizer/v2.1/prebuilt/invoice/analyze返回404的问题，可按以下步骤逐一排查：

• 确认请求方法为POST：该接口仅支持POST请求，若Postman误选GET、PUT等其他请求方法，会直接返回404。微软官方测试页会自动适配请求方法，手动调用时容易遗漏该配置。
• 确认资源区域匹配：你当前使用的是澳大利亚东部区域的端点，如果你的Form Recognizer Azure资源是在其他区域创建的，需要将URL前缀的australiaeast替换为你自己资源对应的区域编码，区域不匹配会直接触发404。
• 确认路径拼写完全正确：检查URL中是否有大小写错误、多余斜杠、拼写错误，比如把v2.1写为V2.1、prebuilt写为preBuild都会导致路由匹配失败，返回404。
• 确认请求头配置正确：必须在请求头中添加Ocp-Apim-Subscription-Key字段，值为你Azure账号下对应Form Recognizer资源的访问密钥，未正确配置该请求头也可能返回404而非权限错误。
• 确认资源层级支持：如果你使用的是免费层（F0）的Form Recognizer资源，部分旧配额的免费层不支持v2.1版本的预构建发票接口，升级到标准层（S0）即可正常调用。
• 确认查询参数正确：如果需要在URL后追加查询参数（比如includeTextDetails、locale），要确认参数拼写符合官方要求，错误的查询参数也可能导致路由匹配失败。

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