Azure Pipeline部署认知搜索技能集时遇URI格式错误求助

• 核对FUNCTIONAPPNAME参数的实际传入值

  • 查看Azure Pipeline部署日志，确认参数是否存在空格、非法特殊字符（Azure函数应用名称仅允许小写字母、数字、连字符），是否为空值或带多余前缀/后缀。
  • 确认拼接后的完整URI（如https://{FUNCTIONAPPNAME}.azurewebsites.net/api/TEST）是否符合标准格式，重点检查是否遗漏https://前缀、域名与接口路径间的/分隔符。

• 检查Bicep/JSON模板中的URI拼接逻辑

  • 对比SharePoint与Blob部署场景下的模板差异，确认Blob部署模板中是否存在字符串拼接错误（例如变量引用错误、缺少必要的分隔符）。
  • 验证模板中URI的生成代码，比如是否存在类似${functionAppName}azurewebsites.net这种漏写.的情况。

• 直接验证技能集URI的有效性

  • 将拼接后的URI复制到浏览器或Postman中测试，确认是否能正常访问函数接口，排除URI本身不可用的问题。
  • 检查URI中是否存在未转义的特殊字符（如&、%等），若有需在模板中做转义处理。

• 核对技能集JSON定义的语法细节

  • 对比SharePoint部署时可用的技能集JSON，确认Blob部署版本中#3 - TEST技能的uri字段拼写正确（避免写成url等错误字段），且JSON结构无语法错误（如多余引号、逗号）。

• 排查函数应用的访问配置

  • 确认函数应用是否允许Azure Cognitive Search的IP访问，或是否开启了IP限制导致URI访问失败（部分情况下权限问题可能被误报为格式错误）。
  • 检查函数应用的身份验证设置，若启用了Azure AD验证，需确保技能集的URI配置了正确的身份凭据。

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