Jenkins声明式Pipeline执行dotnet命令提示‘dotnet: not found’求助

问题原因 #

你遇到的dotnet: not found错误，核心原因是运行Jenkins的Docker容器中未安装.NET SDK，或者Jenkins Pipeline未正确加载已配置的.NET SDK环境。你安装的MSBuild插件仅提供MSBuild构建工具，而dotnet CLI属于.NET SDK的一部分，二者是独立组件。

解决方案 #

方案1：自定义Jenkins Docker镜像，预安装.NET 6.0 SDK #

默认Jenkins官方镜像不包含.NET SDK，可通过编写Dockerfile自定义镜像提前安装：

FROM jenkins/jenkins:lts
USER root

# 安装依赖并添加Microsoft软件源
RUN apt-get update && apt-get install -y wget && \
    wget https://packages.microsoft.com/config/debian/11/packages-microsoft-prod.deb -O packages-microsoft-prod.deb && \
    dpkg -i packages-microsoft-prod.deb

# 安装.NET 6.0 SDK
RUN apt-get update && apt-get install -y dotnet-sdk-6.0

# 切换回jenkins用户
USER jenkins

构建镜像并重启Jenkins容器后，dotnet命令即可直接在Pipeline中使用。

方案2：通过Jenkins .NET SDK Support插件自动安装 #

若不想自定义镜像，可利用Jenkins工具自动安装功能：

1. 进入Jenkins 全局工具配置，找到.NET SDK配置项，添加.NET 6.0的安装配置（名称比如设为DotNet6.0），勾选「自动安装」并选择对应版本。
2. 修改Jenkinsfile，在tools块中引入配置好的.NET SDK，确保环境变量包含dotnet路径：

pipeline {
    agent any
    tools {
        dotnet 'DotNet6.0' // 此处名称需与全局工具配置中的.NET SDK名称完全一致
    }
    stages {
        stage('Clean'){
            steps{
                sh "dotnet clean ${env.WORKSPACE}/GameOfDice.sln --configuration Release"
            }
        }
        // 其他阶段代码...
    }
}

运行Pipeline时，Jenkins会自动下载安装指定版本的.NET SDK，并将dotnet加入当前Pipeline的环境变量。

关键排查点 #

• 不要混淆MSBuild和.NET SDK：MSBuild是构建工具，dotnet CLI属于.NET SDK组件，仅配置MSBuild无法解决dotnet命令找不到的问题。
• 若使用自定义Jenkins代理节点，需确保代理节点已安装.NET SDK，或同样配置自动安装规则。

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