ADF参数化链接服务报错：linkedService模板函数未定义

问题背景 #

配置了两个带environment参数的Linked Service：Azure Key Vault（AKV）和Azure Data Lake Storage（ADLS）。AKV本身可正常获取密钥，但ADLS尝试将自身的environment参数传递给AKV以获取存储密钥时，触发错误：

错误码：FailToResolveParametersInExploratoryController
提示：模板函数'linkedService'未定义或无效

调试确认问题出在ADLS配置第38行的@linkedService().environment表达式：

• 替换为硬编码值可正常连接；
• 使用@string(linkedService.environment)可正常工作，但直接引用linkedService.environment会导致参数被自动添加引号，生成无效的AKV地址；
• 官方界面提供该表达式选项，但实际调用报错。

根因分析 #

1. 上下文解析限制：在ADLS Linked Service的密钥引用段（即调用AKV获取密钥的配置区域），ADF的表达式解析器无法正确识别linkedService()函数的上下文——此时的执行环境属于AKV Linked Service的参数解析流程，而非ADLS自身的参数上下文，因此会抛出“函数未定义”的错误。
2. 参数传递格式问题：直接引用参数（如linkedService.environment）时，ADF会将参数值以带引号的字符串字面量形式传递，而AKV的URL需要无引号的纯字符串，因此导致地址无效。

解决办法 #

方法1：用string()函数包裹参数引用 #

将报错的表达式@linkedService().environment替换为@string(linkedService().environment)，既可以避免函数上下文解析错误，又能确保参数以纯字符串形式传递，不会自动添加引号。

方法2：使用临时变量中转参数 #

在ADLS Linked Service的配置中添加变量定义，先将environment参数赋值给临时变量，再在AKV引用中使用该变量：

"variables": {
  "currentEnv": "@linkedService().environment"
},

然后在AKV参数传递部分使用@variables('currentEnv')，通过变量中转绕过上下文解析的限制。

方法3：确保参数类型一致 #

检查AKV和ADLS的environment参数类型，确保二者均配置为字符串类型。类型不匹配可能会触发解析器的异常处理，导致函数调用报错。

注意事项 #

• 在Linked Service嵌套参数传递的场景中，优先使用string()函数包裹参数引用，保证传递值的格式符合目标服务的要求；
• 若手动编辑JSON配置，需严格遵循ADF表达式语法：函数调用必须带括号（如linkedService()而非linkedService），表达式必须以@开头。

内容的提问来源于stack exchange，提问作者JP-Ellis