Azure托管应用调用自定义提供程序时出现路由未定义报错的实现与排查
报错核心成因
- 路径双重拼接导致路由不匹配:Azure门户加载托管应用视图时,处理命令类操作的
path字段有固定的补全逻辑——会自动将当前托管应用绑定的自定义提供程序根名称作为请求前缀拼接。你当前在视图配置的路径已经携带了自定义提供程序的根名public/,最终实际请求的Action路径会被拼成public/public/product/GetDocumentation,和自定义提供程序实际注册的public/product/GetDocumentation路由完全对不上。这也是你用Azure CLI手动调用能正常收到Function响应的原因:CLI请求是手动指定了完整的自定义提供程序资源ID和准确的Action名,没有额外的自动前缀拼接逻辑。 - 资源查找范围错位:你当前的自定义提供程序部署在托管资源组(MRG)内部,默认门户视图命令的查找逻辑只会定位托管应用外部的公共自定义提供程序资源,不会自动识别MRG内部署的提供程序实例,即使路由配置正确,也会因为找不到对应提供程序资源抛出同类报错。
正确实现的修正步骤
- 调整视图命令的路径配置:把
viewDefinition.json里所有命令的path字段,从当前的public/product/GetDocumentation修改为product/GetDocumentation——也就是去掉路径里的自定义提供程序根名段。这个配置的核心规则是,视图命令的path只需要填写自定义提供程序下注册的Action的相对路径,门户会自动补全完整的自定义提供程序资源ID作为请求前缀。 - 配置托管应用与MRG内自定义提供程序的关联:在托管应用的部署模板中,明确将MRG内部署的自定义提供程序资源ID传递给托管应用的门户上下文,让门户在加载视图时,能直接定位到MRG内的提供程序实例,不会去订阅范围的公共资源区查找同名的提供程序。
- 校验Function App的端点路由匹配性:确认你配置的自定义提供程序端点
https://faraveXXXX.azurewebsites.net/api/{requestPath}能正常接收product/GetDocumentation路径的请求——当门户按正确规则转发请求时,实际传到Function的路径参数就是你配置的相对路径,刚好匹配占位符的替换逻辑,不会出现路由不匹配的问题。 - 部署完成后做链路验证:点击概览页的操作按钮,门户实际发出的请求路径会被自动组装为
[MRG内自定义提供程序资源完整ID]/actions/product/GetDocumentation,和自定义提供程序里注册的Action名称完全匹配,即可正常触发Function逻辑并返回响应。
内容的提问来源于stack exchange,提问作者Rob S.
相关产品推荐
相关产品推荐

