Azure Data Factory参数化链接服务执行管道触发Base64密钥无效错误

问题分析 #

你的链接服务虽定义了accountkey参数，但typeProperties中并未实际引用该参数，而是硬编码了占位符值。测试连接正常是因为测试时手动输入了正确密钥，但管道执行时传递的参数未被正确关联，且特殊字符未得到正确处理，导致Base64格式校验失败。

解决方案 #

1. 修正链接服务配置，正确引用参数 #

修改链接服务的typeProperties部分，将accountkey的value改为引用定义好的参数，同时将参数类型改为SecureString以避免明文传递和编码问题：

{
    "name": "MyLinkedService",
    "type": "Microsoft.DataFactory/factories/linkedservices",
    "properties": {
        "type": "AzureBlobFS",
        "parameters": {
            "URL": {
                "type": "String"
            },
            "accountkey": {
                "type": "SecureString"
            }
        },
        "typeProperties": {
            "url": "@{linkedService().URL}",
            "accountkey": {
                "type": "SecureString",
                "value": "@{linkedService().accountkey}"
            }
        },
        "annotations": []
    }
}

2. 管道参数传递规范 #

• 调用链接服务时，传递的accountkey必须是Azure存储账户的原始Base64格式密钥，不要进行URL编码或其他转义操作。
• 若通过管道参数传递密钥，需将管道参数的类型同样设置为SecureString，确保+、/、=等Base64允许的特殊字符不会被转义或篡改。

3. 验证参数完整性 #

如果密钥通过变量或其他逻辑生成，需确保最终传递给链接服务的是未经过任何额外处理的原始密钥字符串。Azure存储账户密钥本身是合法的Base64格式，只要传递正确就不会触发格式错误。

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