.NET Framework Azure Function无法绑定lockToken参数问题

我之前在维护.NET Framework版本的Azure Function时也遇到过一模一样的问题，这本质上是因为.NET Framework和.NET Core版本的Azure Functions所依赖的Service Bus绑定API存在差异，导致你在.NET Core里能用的参数绑定方式在.NET Framework里行不通。

你在.NET Core里用的是新版的Azure.Messaging.ServiceBus SDK对应的绑定（Microsoft.Azure.WebJobs.Extensions.ServiceBus v3+），这个版本支持直接将lockToken作为独立参数绑定，不管是string还是Guid类型都能正常工作。但.NET Framework版本的Azure Function（尤其是Runtime v1，也是最常见的.NET Framework Function版本）默认依赖的是旧版的Service Bus绑定，它基于Microsoft.ServiceBus.Messaging SDK，对应的消息类型是BrokeredMessage，而且不支持直接将lockToken作为独立参数绑定，这就是你报错的核心原因。

解决方案步骤 #

1. 调整NuGet包依赖
   卸载项目中所有Azure.Messaging.ServiceBus相关的包，然后安装适配.NET Framework Function的包：

   • 安装Microsoft.Azure.WebJobs.Extensions.ServiceBus（版本选择2.x系列，比如2.3.0，这个版本是专门给.NET Framework的Function Runtime v1/v2准备的）
   • 安装Microsoft.ServiceBus包（旧版Service Bus SDK，提供BrokeredMessage类型）

2. 修改函数代码
   将消息参数类型从Message改为BrokeredMessage，并且不需要单独的lockToken参数，直接从BrokeredMessage实例中获取LockToken属性：

   [FunctionName("Function1")]
   public static async Task RunAsync(
       [ServiceBusTrigger("topic", "sub", Connection = "ConnectionStringSettingName")]BrokeredMessage mySbMsg,
       MessageReceiver messageReceiver,
       ILogger log)
   {
       // 直接从消息实例中获取lockToken
       string lockToken = mySbMsg.LockToken;
       log.LogInformation($"C# ServiceBus topic trigger function processed message: {mySbMsg.MessageId}, LockToken: {lockToken}");
       
       // 如果需要操作消息（比如完成、放弃），可以用messageReceiver结合lockToken
       // await messageReceiver.CompleteAsync(lockToken);
   }
   

3. 可选：如果使用Function Runtime v2+（.NET Framework 4.7.2+）
   如果你用的是支持.NET Framework的Function Runtime v2或更高版本，也可以尝试使用新版的Service Bus绑定，但需要确保：

   • 安装Microsoft.Azure.WebJobs.Extensions.ServiceBus v3+版本
   • 在项目的Startup类中注册Service Bus扩展：

     using Microsoft.Azure.WebJobs;
     using Microsoft.Azure.WebJobs.Hosting;
     using Microsoft.Extensions.DependencyInjection;
     
     [assembly: WebJobsStartup(typeof(YourNamespace.Startup))]
     namespace YourNamespace
     {
         public class Startup : IWebJobsStartup
         {
             public void Configure(IWebJobsBuilder builder)
             {
                 builder.AddServiceBus();
             }
         }
     }
     

   这种情况下，你可以继续使用Message类型，但需要注意lockToken的绑定方式：在新版绑定中，.NET Framework环境下可能还是需要通过Message.SystemProperties.LockToken来获取，而不是作为独立参数绑定。

按照上面的步骤调整后，你的.NET Framework Azure Function应该就能正常运行了。核心就是要匹配对应Runtime版本的Service Bus绑定API，不要混用新旧版本的SDK和绑定方式。

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