Jenkins流水线MSBuild构建时找不到Npgsql 4.0.5包的问题

问题描述 #

通过Jenkins流水线使用MSBuild构建.NET解决方案，流水线包含三个阶段：代码检出、NuGet包恢复、构建。其中代码检出和NuGet恢复阶段执行成功，但构建阶段报错。

流水线脚本 #

environment {
        nuget = "C:/nuget.exe"
    }
stages {
        stage('Restore Nuget Packages') {
            steps {
                script {
                       bat '%nuget% restore "./trunk/BALANCE/TakK_BAL.sln\"'
                       }
                        
        }
        }
        stage('Build') {
            steps {
                script {
                       bat "\"${tool 'MSBuild'}\\MSBuild.exe\" \"./trunk/BALANCE/TakK_BAL.sln\" /p:Configuration=Debug /p:Platform=\"x64\" "
                       }
                        
        }
        }

构建错误信息 #

C:\Program Files\Microsoft Visual Studio\2022\Community\MSBuild\Microsoft\NuGet\17.0\Microsoft.NuGet.targets(198,5): 
error : The package Npgsql with version 4.0.5 could not be found in 
C:\Windows\system32\config\systemprofile\.nuget\packages\, 
C:\Program Files (x86)\Microsoft Visual Studio\Shared\NuGetPackages. 
Run a NuGet package restore to download the package. 
[C:\Users\ramin.bohlouli\.jenkins\workspace\BalanceTestPipeline\trunk\BALANCE\BalanceOptimaConnector\BalanceOptimaConnector.csproj]

已排查情况 #

• 在C:\Windows\system32\config\systemprofile\.nuget\packages\和%userprofile%\.nuget\packages目录下均能找到Npgsql 4.0.5版本包
• Visual Studio中确认解决方案已安装该版本包

原因分析 #

1. 工具上下文不一致：使用独立nuget.exe执行恢复，与MSBuild集成的NuGet工具存在配置差异，导致恢复的包路径无法被MSBuild正确识别；Jenkins服务运行账户（如Local System）的上下文也可能引发路径解析或权限问题。
2. 项目包引用配置异常：报错的子项目（BalanceOptimaConnector.csproj）可能存在配置问题，比如旧版packages.config未同步，或PackageReference属性配置错误。
3. 版本不兼容：nuget.exe版本与MSBuild集成的NuGet版本不匹配，导致恢复的包元数据或结构无法被MSBuild解析。

解决方案 #

1. 统一NuGet恢复与构建的包路径 #

修改流水线脚本，指定NuGet包恢复到Jenkins工作目录内的本地文件夹，规避系统目录的上下文问题：

environment {
    nuget = "C:/nuget.exe"
    packagesDir = "./.nuget/packages" // 工作目录内的本地包存储目录
}
stages {
    stage('Restore Nuget Packages') {
        steps {
            script {
                bat '%nuget% restore "./trunk/BALANCE/TakK_BAL.sln" -PackagesDirectory "%packagesDir%"'
            }
        }
    }
    stage('Build') {
        steps {
            script {
                bat "\"${tool 'MSBuild'}\\MSBuild.exe\" \"./trunk/BALANCE/TakK_BAL.sln\" /p:Configuration=Debug /p:Platform=\"x64\" /p:RestorePackagesPath=\"%packagesDir%\""
            }
        }
    }
}

2. 使用MSBuild自带的Restore目标替代独立nuget.exe #

让MSBuild直接执行包恢复，确保恢复与构建使用同一工具上下文：

stages {
    stage('Restore Nuget Packages') {
        steps {
            script {
                bat "\"${tool 'MSBuild'}\\MSBuild.exe\" \"./trunk/BALANCE/TakK_BAL.sln\" /t:Restore /p:Configuration=Debug /p:Platform=\"x64\""
            }
        }
    }
    stage('Build') {
        steps {
            script {
                bat "\"${tool 'MSBuild'}\\MSBuild.exe\" \"./trunk/BALANCE/TakK_BAL.sln\" /t:Build /p:Configuration=Debug /p:Platform=\"x64\""
            }
        }
    }
}

也可合并为单阶段执行：/t:Restore;Build

3. 检查并修复项目包引用配置 #

• 打开报错的BalanceOptimaConnector.csproj，确认包引用格式：
  • 若使用packages.config，确保该文件已被正确检出到Jenkins工作目录，路径配置无误；
  • 若使用PackageReference，确认Version属性为4.0.5，无错误的PrivateAssets/IncludeAssets配置。

4. 验证Jenkins服务账户权限 #

• 确认Jenkins运行账户对C:\Windows\system32\config\systemprofile\.nuget\packages\目录有读取权限；
• 可尝试将Jenkins服务切换到具有明确文件系统权限的本地/域账户运行，避免Local System账户的上下文限制。

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