Azure隔离式函数部署失败：启动异常与程序集缺失问题

核心问题拆解 #

部署Linux P1v3计划的隔离式.NET函数时出现以下异常：

Microsoft.Azure.WebJobs.Script.ExternalStartupException，内部异常：找不到程序集'Microsoft.AspNetCore.Routing, Version=7.0.0.0'

同时存在两个关键疑惑：

1. 隔离式函数无需Startup属性却触发该异常
2. 项目未直接引用该版本程序集却出现依赖

原因定位 #

1. Startup异常触发原因：你引用的Microsoft.Azure.Functions.Extensions是针对In-Process模型的扩展包，它会触发In-Process模式下的Startup扫描逻辑，而隔离式Worker模型并不兼容这个逻辑，从而抛出ExternalStartupException。
2. 依赖版本冲突：项目中某个第三方NuGet包（比如Microsoft.Azure.Functions.Worker.Extensions.Sql或Microsoft.ApplicationInsights.WorkerService）间接依赖了Microsoft.AspNetCore.Routing 7.0.0，而你的项目整体基于.NET 8，部署时Azure环境的.NET 8 runtime无法找到7.0版本的组件，导致程序集缺失。

具体解决步骤 #

1. 移除不兼容的In-Process扩展包 #

删除项目文件中的Microsoft.Azure.Functions.Extensions引用：

<!-- 移除这一行 -->
<PackageReference Include="Microsoft.Azure.Functions.Extensions" Version="1.1.0" />

2. 显式指定兼容的程序集版本 #

在项目文件中添加.NET 8版本的Microsoft.AspNetCore.Routing引用，强制覆盖间接依赖的7.0版本：

<PackageReference Include="Microsoft.AspNetCore.Routing" Version="8.0.0" />

3. 调整部署配置为自包含模式 #

修改项目发布配置，确保打包所有依赖，避免依赖Azure环境的预装runtime：

<PropertyGroup>
  <TargetFramework>net8.0</TargetFramework>
  <AzureFunctionsVersion>v4</AzureFunctionsVersion>
  <OutputType>Exe</OutputType>
  <PublishSingleFile>False</PublishSingleFile>
  <SelfContained>True</SelfContained>
  <RuntimeIdentifier>linux-x64</RuntimeIdentifier>
</PropertyGroup>

4. 清理Azure部署缓存 #

进入Azure门户的函数应用 → 高级工具(Kudu) → Debug console → Bash，执行命令清理旧部署文件：

rm -rf site/wwwroot/*

之后重新发布项目。

5. 验证间接依赖（可选） #

执行以下命令查看完整依赖链，确认哪个包引入了7.0版本的组件：

dotnet list package --include-transitive

根据结果针对性升级或替换冲突的包。

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