sqlpackage提示.NET位置未找到：构建服务器运行问题求助

运行构建服务器上的sqlpackage.exe时，持续收到以下错误：

You must install .NET to run this application.

App: C:\Users\its-bi-cicd-svc-p\.dotnet-cli-tools\tools\sqlpackage.exe
Architecture: x64
App host version: 7.0.5
.NET location: Not found

本地开发环境可正常执行该工具，已按要求使用就地安装的.NET SDK，并将sqlpackage工作目录设置为SDK安装目录，但问题依旧。服务器已安装PowerShell 7.3.4，通过[Environment]::Version验证存在7.0.5版本的.NET运行时，但sqlpackage无法识别。

核心疑问：

• sqlpackage的.NET版本查找路径是什么？
• 如何让它定位到已安装的SDK版本？
• 为何通过SDK安装的sqlpackage不默认使用该SDK的运行时？

1. 检查并调整环境变量优先级 #

确保.NET SDK的安装目录（通常为C:\Program Files\dotnet\）已添加到系统PATH环境变量，且优先级高于其他.NET相关路径。执行以下命令验证路径顺序：

$env:PATH -split ';' | Where-Object { $_ -match 'dotnet' }

若SDK路径未排在首位，手动调整PATH顺序后重试。

2. 通过.NET CLI调用sqlpackage #

避免直接运行sqlpackage.exe，改用.NET CLI启动工具，强制使用当前激活的SDK运行时：

dotnet sqlpackage <你的命令参数>

3. 验证架构匹配性 #

确认已安装的.NET SDK/运行时为x64架构，与报错中显示的Architecture: x64一致。执行命令查看已安装的运行时：

dotnet --list-runtimes

若存在x86版本运行时，需确保x64版本在PATH中优先级更高。

4. 手动指定DOTNET_ROOT变量 #

设置环境变量指向.NET SDK安装目录，覆盖默认查找逻辑：

$env:DOTNET_ROOT = "C:\Program Files\dotnet\"
& "C:\Users\its-bi-cicd-svc-p\.dotnet-cli-tools\tools\sqlpackage.exe" <你的命令参数>

5. 重新绑定sqlpackage的运行时版本 #

若sqlpackage是通过dotnet tool install安装的，重新安装并指定目标框架版本，确保与服务器SDK版本匹配：

dotnet tool uninstall -g microsoft.sqlpackage
dotnet tool install -g microsoft.sqlpackage --framework net7.0

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