Azure DevOps Server 2019本地版手动安装Code Search插件失败求助

前置要求 #

• 服务器需满足Azure DevOps Server 2019官方最低系统要求，包括Windows Server版本（2016/2019）、.NET Framework 4.7.2及以上版本
• 安装账号需同时拥有Azure DevOps Server管理员权限和本地服务器的本地管理员权限
• 服务器已安装Azure DevOps Server 2019的最新更新补丁，手动安装包依赖服务器最新版本组件
• 本地SQL Server实例运行正常，且服务器能正常访问该实例（Code Search需存储元数据至SQL）
• 使用的手动安装包必须是Azure DevOps Server 2019专属版本，不可跨版本使用（如2020或云环境包）

后续解决方向 #

• 验证安装包完整性：重新从官方渠道下载对应2019版本的Code Search手动安装包，核对文件哈希值与官方校验值一致，排除包损坏导致的报错
• 检查安装日志：前往%temp%目录查找安装日志文件（命名格式如AzureDevOpsCodeSearchSetup_*.log），从日志中提取具体报错信息，定位权限、依赖或配置类问题
• 手动补全依赖组件：若日志提示缺失VC++运行库、IIS组件等依赖，先手动安装对应组件后重试安装
• 关闭冲突服务：安装前停止Azure DevOps相关服务（如TFSJobAgent、Azure DevOps Server应用池），避免进程占用导致安装失败
• 匹配配置参数：对比Marketplace安装时自动配置的服务账户、数据库连接等参数，手动安装时输入完全一致的配置信息
• 清理后重装：若存在未完成的残留安装文件，先卸载已有Code Search组件，运行Azure DevOps Server修复工具，再重新执行手动安装

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