Jenkins Pipeline部署Azure Web App遇空指针错误求助

首先看你提供的堆栈信息，这个NullPointerException出现在hudson.FilePath.isAbsolute方法里，追踪到是Azure插件的GitDeployCommand.copyAndAddFiles在尝试遍历文件时，传入的路径对象为null。结合你的Jenkinsfile和执行日志，核心问题大概率是指定的sourceDirectory路径无效，或者插件对publishType的处理不符合预期，给你几个具体的排查和解决步骤：

1. 先确认sourceDirectory的存在性 #

插件在找不到指定的源目录时，没有抛出明确的错误提示，反而触发了空指针。你可以在发布步骤前加一个验证环节，提前确认目录是否存在：

stage("Validate Source Directory") {
    steps {
        script {
            def workspaceDir = currentBuild.workspace
            if (!workspaceDir) {
                error("Workspace is not available!")
            }
            def sourceDir = new FilePath(workspaceDir, "docs/export")
            if (!sourceDir.exists()) {
                error("Source directory ${sourceDir} does NOT exist in workspace!")
            }
            echo "✅ Source directory verified: ${sourceDir}"
        }
    }
}

如果这个步骤报错，说明你的构建产物没有生成到docs/export目录，需要先检查前面的构建步骤是否正确输出了文件到这个路径。

2. 修正publishType参数的使用 #

你设置了publishType: "file"，但执行日志里插件却在执行Git克隆操作，这明显不符合预期。file类型应该是直接上传本地文件，而不是走Git部署流程。建议尝试：

• 把publishType改为"package"，并明确指定要上传的文件匹配规则：

stage("Publish to Azure") {
    steps {
        azureWebAppPublish ([
            appName: "xxx",
            azureCredentialsId: "xxx",
            publishType: "package",
            resourceGroup: "xxx",
            sourceDirectory: "docs/export",
            package: "**/*" // 匹配目录下所有文件及子目录
        ])
    }
}

这个参数组合更符合直接上传本地文件的场景，能避免插件误触发Git部署流程。

3. 检查Jenkins节点的路径权限 #

你的Jenkins运行在Windows节点（日志显示C:\Program Files\Git\bin\git.exe），需要确认：

• D:\Jenkins\workspace\xxx\docs\export这个物理路径确实存在
• Jenkins服务运行的账号（比如Local System或者指定的域账号）有该目录的读取权限
  可以加一个bat命令直接验证：

stage("Check Path & Permissions") {
    steps {
        bat 'dir "D:\\Jenkins\\workspace\\xxx\\docs\\export"'
    }
}

如果命令执行失败，说明路径不存在或者权限不足，需要先解决这个问题。

4. 更新Azure Web App Deployment插件 #

这个空指针异常很可能是插件的已知bug，旧版本的插件在路径处理上存在漏洞。进入Jenkins的插件管理页面，找到Azure Web App Deployment插件，更新到最新的稳定版本，很多这类路径相关的bug在新版本中已经修复。

备选方案：用Azure CLI绕开插件问题 #

如果上述方法都无效，可以尝试直接使用Azure CLI命令部署，避免插件的坑：

stage("Publish via Azure CLI") {
    steps {
        script {
            // 使用服务主体登录Azure（提前在Jenkins配置好凭证）
            withCredentials([string(credentialsId: 'azure-sp-secret', variable: 'AZURE_SECRET')]) {
                bat """
                    az login --service-principal -u <你的服务主体ID> -p ${AZURE_SECRET} --tenant <你的租户ID>
                    az webapp deploy --name xxx --resource-group xxx --src-path docs/export --type zip
                """
            }
        }
    }
}

记得替换命令中的服务主体ID、租户ID，并且在Jenkins中配置好对应的凭证。

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