如何通过PowerShell脚本后台启动本地API并调用Swagger端点？

问题描述 #

需要通过PowerShell脚本本地启动API并自动调用Swagger端点生成代码。已知直接执行以下命令能正常启动API并访问Swagger：

Invoke-Expression "dotnet run 'MyApi.csproj' --no-build --launch-profile 'RUNLOCAL'"

但希望脚本自动完成后续步骤：等待API启动后调用openapi-generator-cli。尝试用Start-Job后台启动API后，API始终无法被访问，端口检测循环一直返回false，完整脚本如下：

$mypath = Get-Location

$ScriptBlock = {
    "dotnet run"    
    'MyApi.csproj'
    "--no-build"
    "--launch-profile 'RUNLOCAL'"
  }

cd "../../Path/To/Project.csproj"

# 尝试后台启动API
Start-Job -ScriptBlock $ScriptBlock

cd $mypath

# 等待API启动完成
while (!(Test-NetConnection localhost -Port 5001).TcpTestSucceeded) { Start-Sleep 1 }

openapi-generator-cli.cmd generate -g csharp-netcore -i https://localhost:5001/swagger/v1/swagger.json 

核心问题分析 #

1. 你编写的ScriptBlock只是输出了几个独立字符串，并没有真正执行dotnet run命令
2. Start-Job启动的后台作业有独立运行环境，当前脚本的目录切换不会同步到作业内部

解决方案 #

方案1：用Start-Process后台启动API（更简单可靠） #

不需要使用Start-Job，直接用Start-Process启动dotnet run进程，让它在后台运行：

$mypath = Get-Location
# 替换为你的项目文件实际路径
$projectPath = "../../Path/To/MyApi.csproj"

# 后台启动API，指定项目所在目录为工作目录
Start-Process dotnet -ArgumentList "run", "--no-build", "--launch-profile", "RUNLOCAL" -WorkingDirectory (Split-Path $projectPath -Parent)

cd $mypath

# 等待API启动完成，添加提示信息便于排查
while (!(Test-NetConnection localhost -Port 5001).TcpTestSucceeded) { 
    Start-Sleep 1 
    Write-Host "等待API启动中..."
}

# 执行代码生成命令
openapi-generator-cli.cmd generate -g csharp-netcore -i https://localhost:5001/swagger/v1/swagger.json 

# 可选：代码生成完成后自动关闭API进程
Get-Process dotnet | Where-Object { $_.CommandLine -match "MyApi.csproj" } | Stop-Process

方案2：修复Start-Job脚本块（若坚持用作业方式） #

修正脚本块逻辑，让它真正执行命令，并传递正确的工作目录参数：

$mypath = Get-Location
# 替换为你的项目文件实际路径
$projectDir = (Split-Path "../../Path/To/MyApi.csproj" -Parent)

$ScriptBlock = {
    param($TargetDir)
    # 在作业内部切换到项目目录
    Set-Location $TargetDir
    # 执行完整的dotnet run命令
    dotnet run --no-build --launch-profile "RUNLOCAL"
}

# 启动后台作业，传递项目目录参数
Start-Job -ScriptBlock $ScriptBlock -ArgumentList $projectDir

cd $mypath

# 等待API启动完成
while (!(Test-NetConnection localhost -Port 5001).TcpTestSucceeded) { 
    Start-Sleep 1 
    Write-Host "等待API启动中..."
}

openapi-generator-cli.cmd generate -g csharp-netcore -i https://localhost:5001/swagger/v1/swagger.json 

关键注意点 #

• Start-Job的作业环境与当前脚本隔离，必须在脚本块内部手动设置工作目录或传递路径参数
• 脚本块内必须编写可执行的完整命令，不能拆分输出字符串
• Start-Process更适合启动外部进程（如dotnet），无需处理PowerShell作业的环境隔离问题，更轻量直观

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