Azure DevOps Server 2022部分集合完成索引后CodeSearch无法正常工作

一、解决PowerShell Invoke-Sqlcmd/SQLSERVER/SQLPS 警告问题 #

• 卸载旧版SQLPS模块，安装官方推荐的SqlServer模块：

  # 卸载旧模块（如果存在）
  Uninstall-Module SQLPS -Force -ErrorAction SilentlyContinue
  # 安装最新SqlServer模块
  Install-Module -Name SqlServer -Force -AllowClobber -Scope CurrentUser
  

• 修改TriggerCollectionIndexing.ps1脚本开头，强制加载SqlServer模块：

  Import-Module SqlServer -DisableNameChecking
  

• 运行脚本前，先移除可能加载的SQLPS模块：

  Remove-Module SQLPS -Force -ErrorAction SilentlyContinue
  

二、修复部分集合搜索报错/搜不到内容的问题 #

针对搜索报错的集合 #

• 检查搜索服务状态：
  1. 打开服务管理器，确认Azure DevOps Server Search Host Controller和Azure DevOps Server Search Service处于运行状态，无启动失败记录。
  2. 在Azure DevOps管理控制台的CodeSearch配置页，查看对应集合的索引进度，确认是否有任务失败或停滞。
• 清理集合索引缓存：
  1. 停止上述两个搜索服务。
  2. 找到搜索数据目录（默认路径：C:\Program Files\Azure DevOps Server 2022\Search\Data），删除对应集合的索引文件夹。
  3. 重启搜索服务，重新运行TriggerCollectionIndexing.ps1并添加-FullReindex $true参数触发全量索引。
• 检查集合数据库完整性：
  用SQL Server Management Studio连接到集合数据库，执行以下命令检查是否存在损坏：

  DBCC CHECKDB ([你的集合数据库名]) WITH NO_INFOMSGS, ALL_ERRORMSGS
  

针对重装后搜不到内容的集合 #

• 验证扩展安装与权限：
  1. 进入集合的管理页面，确认CodeSearch扩展已启用，且Azure DevOps搜索服务账户拥有集合管理员权限、数据库读写权限。
  2. 检查代码库的权限设置，确保搜索服务账户能访问所有需要索引的代码库。
• 强制触发全量索引：
  修改TriggerCollectionIndexing.ps1中的参数，确保执行全量索引而非增量索引：

  .\TriggerCollectionIndexing.ps1 -CollectionUrl "http://你的服务器URL/集合名" -FullReindex $true
  

• 排查搜索服务日志：
  查看搜索服务日志目录（默认：C:\Program Files\Azure DevOps Server 2022\Search\Logs），查找索引过程中的具体错误信息（如权限不足、文件访问失败、代码库路径异常等）。

三、通用排查与修复步骤 #

• 安装Azure DevOps Server 2022.2最新累积补丁：升级后未打补丁可能存在已知的CodeSearch索引问题，检查并安装官方发布的最新补丁。
• 对比正常与异常集合配置：重点排查异常集合是否包含特殊类型代码库（如TFVC大仓库、Git LFS文件）、是否存在大量历史数据，这类场景可能需要调整索引资源配额。
• 验证搜索服务账户权限：确保服务账户对Azure DevOps安装目录、搜索数据目录、代码库工作目录拥有完全控制权限。

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