使用PowerShell触发Jenkins任务遇认证错误，curl执行正常求排查

我之前也碰到过一模一样的问题——curl能正常触发任务，但PowerShell的Invoke-WebRequest死活报认证错误，核心原因是两者处理URL嵌入式认证的逻辑不一样。咱们一步步来搞定它：

1. 把URL嵌入式认证改成显式认证头 #

curl会自动把URL里的admin:password转换成标准的Basic认证头，但PowerShell的Invoke-WebRequest（尤其是搭配-UseBasicParsing参数时）并不会自动处理这种写法。你可以换成手动构造认证头的方式：

# 拆分配置信息，更易维护
$jenkinsHost = "172.24.235.27:8080"
$jobName = "TestItem1"
$jobToken = "token"
$username = "admin"
$password = "password"

# 拼接完整请求URL
$fullUrl = "http://$jenkinsHost/job/$jobName/build?token=$jobToken"

# 生成Basic认证所需的Base64编码字符串
$base64Auth = [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes("$username:$password"))
$authHeader = @{ "Authorization" = "Basic $base64Auth" }

# 发起带认证头的请求
Invoke-WebRequest -UseBasicParsing -Headers $authHeader -Uri $fullUrl

2. 快速核对Jenkins侧的配置 #

既然curl能正常运行，大部分配置应该没问题，但还是可以确认两点：

• 确保你的admin账号拥有该Jenkins任务的Build权限（在任务配置页的「权限矩阵」或「角色权限」面板里检查）。
• 确认任务的「Build Triggers」中，「Trigger builds remotely」选项已启用，且配置的token和代码里的完全一致。

3. 额外排查点（如果上面的方法没解决） #

• 检查PowerShell版本：如果你用的是PowerShell 5.1及以下，偶尔会有HTTP请求处理的兼容性问题，可以尝试升级到PowerShell 7+再测试。
• 临时关闭CSRF验证（仅测试用）：如果Jenkins开启了CSRF保护，虽然带token的请求理论上会绕过，但可以临时关闭该选项（Manage Jenkins -> Global Security -> 取消勾选「防止跨站点请求伪造」）测试是否是这个原因，测试完成后记得重新开启。

这样调整后，应该就能顺利触发Jenkins任务了。

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