PowerShell调用Java.exe运行Jenkins代理时误报异常的解决需求

问题描述 #

我正在编写一个将Jenkins Agent作为服务托管的开源脚本，需要调用java.exe启动Agent。为确保终止PowerShell脚本时Java进程同步终止，我试过CMD /c和Start-Process，但它们会启动独立进程无法同步终止；只有调用运算符&能满足同步需求，但PowerShell会把Java输出的日志信息误判为异常，抛出NativeCommandError。我需要让真实日志正常输出，同时保留捕获真实错误的能力，已排除$ErrorActionPreference = 'SilentlyContinue'，尝试过2>&1和*>&1但问题依旧。

代码示例：

& "$Java\java.exe" -jar "$JenkinsPath\agent.jar" -url "$JenkinsURL/" -secret $Secret -name $env:computername -workDir "$JenkinsPath" *>>"$JenkinsPath\agent.log"

错误信息：

java.exe : Aug 04, 2024 5:14:14 PM org.jenkinsci.remoting.engine.WorkDirManager initializeWorkDir
At line:1 char:1
+ & "$Java\java.exe" -jar "$JenkinsPath\agent.jar" -url "$JenkinsURL/"  ...
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : NotSpecified: (Aug 04, 2024 5:...itializeWorkDir:String) [], RemoteException
    + FullyQualifiedErrorId : NativeCommandError
 
INFO: Using D:\Jenkins\remoting as a remoting work directory
Aug 04, 2024 5:14:14 PM org.jenkinsci.remoting.engine.WorkDirManager setupLogging
INFO: Both error and output logs will be printed to D:\Jenkins\remoting
Aug 04, 2024 5:14:14 PM hudson.remoting.Launcher createEngine

解决方案 #

方案1：用Start-Process实现同步控制与日志输出 #

通过参数配置，既保证PowerShell与Java进程同步（终止脚本时Java进程也会终止），又能正确捕获日志输出，避免误判异常：

Start-Process -FilePath "$Java\java.exe" `
    -ArgumentList "-jar `"$JenkinsPath\agent.jar`" -url `"$JenkinsURL/`" -secret $Secret -name $env:computername -workDir `"$JenkinsPath`"" `
    -Wait -NoNewWindow `
    -RedirectStandardOutput "$JenkinsPath\agent.log" `
    -RedirectStandardError "$JenkinsPath\agent.log"

参数说明：

• -Wait：让PowerShell等待Java进程结束，实现同步控制
• -NoNewWindow：不在新窗口启动Java进程
• -RedirectStandardOutput/-RedirectStandardError：将标准输出和错误输出重定向到同一个日志文件（也可分开存储）

方案2：处理&调用的错误输出，避免误判 #

如果坚持用&运算符，可通过管道处理输出，将Java的错误流转换为标准输出，过滤掉NativeCommandError：

& "$Java\java.exe" -jar "$JenkinsPath\agent.jar" -url "$JenkinsURL/" -secret $Secret -name $env:computername -workDir "$JenkinsPath" 2>&1 | 
    ForEach-Object {
        if ($_ -is [System.Management.Automation.ErrorRecord]) {
            Write-Output $_.ToString()
        } else {
            Write-Output $_
        }
    } *>> "$JenkinsPath\agent.log"

这种方法保留&的同步终止特性，同时让Java日志正常写入文件，不会误报异常。

方案3：临时调整PowerShell错误处理策略 #

临时修改错误策略，仅对当前命令生效：

# 保存原有错误策略
$originalErrorAction = $ErrorActionPreference
# 设置为Continue，允许错误信息显示但不终止脚本
$ErrorActionPreference = 'Continue'

& "$Java\java.exe" -jar "$JenkinsPath\agent.jar" -url "$JenkinsURL/" -secret $Secret -name $env:computername -workDir "$JenkinsPath" *>>"$JenkinsPath\agent.log"

# 恢复原有错误策略
$ErrorActionPreference = $originalErrorAction

该方法会保留NativeCommandError提示，但脚本会继续执行，日志也能正常写入。

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