更新Azure Core Tools后应用仍用旧版本致启动异常排查

定位旧版本来源的方法 #

• 检查Visual Studio配置：打开「工具」→「选项」→「Azure Functions工具」，确认是否存在旧版本工具的路径配置，VS可能会缓存历史工具路径
• 排查系统环境变量：查看PATH变量，检查是否包含旧版本Azure Core Tools的安装路径，旧版本路径可能未被自动清理
• 检查项目本地配置：再次确认项目根目录的local.settings.json中是否存在FUNCTIONS_CORE_TOOLS_PATH配置项，该值可能指定了旧版本路径；同时查看项目根目录是否有.func隐藏文件夹，里面可能存储了本地工具版本偏好
• 核对NuGet包依赖：检查项目中Azure Functions相关NuGet包（如Microsoft.Azure.Functions.Worker、Microsoft.NET.Sdk.Functions）的版本，确保与新版本Core Tools（4.0.4915）兼容
• 检查系统已安装程序：在「设置」→「应用」→「应用和功能」中搜索Azure Functions Core Tools，确认是否有残留的旧版本条目，部分更新不会自动卸载旧版

移除旧版本并强制使用新版本的步骤 #

• 清理Visual Studio缓存：删除以下目录的缓存文件：
  • %LOCALAPPDATA%\Microsoft\VisualStudio\<你的VS版本号>\ComponentModelCache
  • %USERPROFILE%\AppData\Local\Temp下的Azure Functions相关临时文件
• 更新系统PATH变量：删除PATH中旧版本Core Tools的路径，添加新版本的安装路径（默认路径为C:\Program Files\Microsoft\Azure Functions Core Tools\4）
• 命令行强制切换版本：打开命令提示符，进入项目根目录，执行func use latest命令，强制绑定最新安装的Core Tools版本
• 修复VS扩展：打开VS的「扩展管理」，找到「Azure Functions and Web Jobs Tools」，点击「修复」，确保VS关联最新工具
• 清理项目编译缓存：删除项目的bin和obj文件夹，清理解决方案后重新生成项目

额外注意事项 #

• 确认版本兼容性：确保4.0.4915版本的Core Tools与项目使用的Azure Functions Runtime版本（如v4）匹配
• 安装权限：更新Core Tools时使用管理员权限执行安装程序，避免因权限不足导致文件替换不彻底

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