Azure Functions从3.x升级到4.x后UAT环境运行异常求助

可能的原因及排查步骤 #

• 部署槽的文件残留问题
  尽管你认为部署槽无关，但UAT刚引入部署槽，可能存在槽切换或部署时的旧文件残留。可以尝试：

  1. 清理UAT生产槽和部署槽的wwwroot目录，重新部署最新包
  2. 检查部署槽的应用设置，若启用了WEBSITE_RUN_FROM_PACKAGE，可能存在旧包缓存，需重新生成部署包并更新

• NuGet间接依赖的版本冲突
  你确认了直接引用的CosmosDB包是最新版，但其他依赖包可能间接引入了旧版Microsoft.Azure.WebJobs.Extensions.CosmosDB：

  1. 在本地项目中运行dotnet list package --include-transitive，查看所有间接依赖的包版本，确认是否有旧版被引入
  2. 在项目.csproj中添加配置强制使用指定版本：

     <ItemGroup>
       <PackageReference Include="Microsoft.Azure.WebJobs.Extensions.CosmosDB" Version="3.0.9" />
     </ItemGroup>
     <PropertyGroup>
       <AutoGenerateBindingRedirects>true</AutoGenerateBindingRedirects>
       <GenerateBindingRedirectsOutputType>true</GenerateBindingRedirectsOutputType>
     </PropertyGroup>
     

     或在web.config中添加绑定重定向：

     <dependentAssembly>
       <assemblyIdentity name="Microsoft.Azure.WebJobs.Extensions.CosmosDB" publicKeyToken="31bf3856ad364e35" culture="neutral" />
       <bindingRedirect oldVersion="0.0.0.0-3.0.9.0" newVersion="3.0.9.0" />
     </dependentAssembly>
     

• UAT环境的应用配置差异
  对比Dev/QA和UAT的应用设置：

  1. 确认FUNCTIONS_EXTENSION_VERSION是否设置为~4，保证UAT运行在4.x runtime
  2. 检查是否有WEBSITE_EXTENSIONS_PATH这类自定义扩展路径配置，可能导致加载旧版本扩展

• 部署流程的缓存问题
  确认Dev/QA和UAT的部署方式一致：

  1. 若UAT用CI/CD管道，检查流程中是否缓存了旧NuGet包，导致部署包不是最新版本
  2. 检查CI/CD是否正确清理构建目录，避免旧dll被打包进部署包

• 函数宿主的缓存残留
  在Azure门户中重启UAT的函数应用，或在Kudu控制台执行restart命令，强制刷新宿主加载的程序集，清除旧版本dll缓存

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