Azure AI语言理解应用出现404资源未找到错误求助

可能的原因及排查步骤 #

1. 端点URL格式错误 #

你当前的端点URL包含错误的:analyze-conversations路径，调用CLU预测API时，正确的格式无需冒号，单轮预测的标准端点应为：

https://<resource-name>.cognitiveservices.azure.com/language/analyze-conversations?api-version=2022-10-01-preview

若使用异步批量分析，路径则为/language/analyze-conversations/jobs?api-version=xxx，建议直接从Azure门户的语言服务资源概览页复制官方提供的端点，避免手动拼接出错。

2. 资源名称或配置不匹配 #

• 确认studylanguageservice是Azure门户中创建的语言服务资源的准确名称，检查是否存在拼写错误（大小写、特殊字符）。
• 登录Azure门户，进入该资源的“密钥和端点”页面，核对复制的端点与你配置的是否完全一致。

3. 模型未完成部署 #

CLU模型必须完成部署才能通过预测API访问：

• 登录Azure语言工作室，进入你的CLU项目，查看“部署”列表，确认目标部署状态为成功，且部署名称已在代码中正确引用（若代码需要指定部署名称）。

4. API版本兼容性问题 #

你使用的2022-10-01-preview为预览版本，部分资源可能存在兼容性问题。可尝试切换至稳定版API（如2023-04-01），同时同步调整端点URL中的API版本参数。

5. 密钥权限错误 #

• 确认使用的LSPredictionKey是语言服务资源的预测密钥（而非创作密钥），创作密钥仅用于模型训练和管理，无法调用预测API。
• 在Azure门户的语言服务资源“密钥和端点”页，复制“密钥1”或“密钥2”作为预测密钥使用。

6. 网络访问限制 #

• 检查语言服务资源是否设置了虚拟网络（VNet）或IP防火墙规则，若你的本地IP不在允许列表内，会返回404或403错误。
• 可临时关闭IP防火墙规则（仅用于测试），验证是否能正常访问。

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