.NET 4.8独立进程Azure Function ServiceBus触发参数转换异常排查

你的推测是否正确？ #

是的，这个转换错误明确说明函数实际运行在进程内模式。进程内模式下的ServiceBusTrigger默认会将消息体解析为System.String，而你代码中使用的ServiceBusReceivedMessage是Azure Functions独立进程模式专属的参数类型，因此出现类型转换失败的异常。

为什么会运行在进程内模式？ #

核心原因是**.NET Framework 4.8不支持Azure Functions的独立进程（dotnet-isolated）模式**。独立进程模式仅支持.NET Core 3.1、.NET 5及以上版本的.NET Core/.NET系列框架，.NET Framework（包括4.8）只能运行在进程内模式。即使你在应用设置中指定了FUNCTIONS_WORKER_RUNTIME=dotnet-isolated，运行时也会自动忽略该配置，强制回退到进程内模式。

修正方案 #

由于你依赖WCF无法升级框架，只能适配进程内模式的用法，具体调整如下：

1. 调整NuGet包引用 #

移除所有独立进程模式相关的包，改用进程内模式的ServiceBus扩展包：

<!-- 移除以下独立进程模式包 -->
<PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.ServiceBus" Version="5.18.0" />
<PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.Timer" Version="4.0.1" />
<PackageReference Include="Microsoft.Azure.Functions.Worker" Version="1.10.0" />
<PackageReference Include="Microsoft.Azure.Functions.Worker.Sdk" Version="1.7.0" />

<!-- 添加进程内模式的对应扩展包，版本适配v4 runtime -->
<PackageReference Include="Microsoft.Azure.WebJobs.Extensions.ServiceBus" Version="5.11.0" />
<PackageReference Include="Microsoft.Azure.WebJobs.Extensions.Timer" Version="4.3.0" />
<!-- 保留Azure.Messaging.ServiceBus用于消息处理 -->
<PackageReference Include="Azure.Messaging.ServiceBus" Version="7.17.5" />

2. 修改.csproj配置 #

移除独立进程模式的OutputType配置，进程内模式为类库类型：

<TargetFramework>net48</TargetFramework>
<AzureFunctionsVersion>v4</AzureFunctionsVersion>
<!-- 移除 <OutputType>Exe</OutputType> -->

3. 调整函数代码 #

将独立进程模式的[Function]装饰器改为进程内模式的[FunctionName]，并适配参数类型：

using Microsoft.Azure.WebJobs;
using Microsoft.Azure.WebJobs.ServiceBus;

[FunctionName("myspecialfunction")]
public async Task Run(
    [ServiceBusTrigger("myspecialqueue", Connection = "<secret>")] ServiceBusReceivedMessage message,
    MessageReceiver messageReceiver)
{
    // 你的业务逻辑实现
}

注：进程内模式下，若仅需消息体内容，可直接将参数类型改为string；若需要操作消息（如完成、放弃），使用MessageReceiver替代独立进程模式的ServiceBusMessageActions。

4. 修正应用设置 #

将FUNCTIONS_WORKER_RUNTIME的值改为dotnet（进程内模式的标识）：

{
    "name": "FUNCTIONS_WORKER_RUNTIME",
    "value": "dotnet",
    "slotSetting": false
}

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