Azure DevOps Ubuntu Agent安装SqlPackage后调用失败问题求助

问题根源 #

Linux环境下，dotnet全局工具默认安装在$HOME/.dotnet/tools目录，但这个路径默认不在Azure DevOps代理会话的PATH环境变量中。即便拆分任务重启PowerShell会话，代理也不会自动将该路径加入全局PATH，导致系统找不到对应命令。另外Linux是大小写敏感系统，安装提示的命令是小写sqlpackage，若调用时用大写SqlPackage也会触发找不到命令的错误。

解决方案 #

方案1：临时添加路径到当前会话

在调用SqlPackage之前，先将dotnet工具路径追加到PATH：

# 安装工具
dotnet tool install --global microsoft.sqlpackage
# 添加工具路径到当前会话PATH
$env:PATH += ":$HOME/.dotnet/tools"
# 调用（注意用小写sqlpackage）
sqlpackage /Action:Publish /SourceFile:"$($dacpac.FullName)" /TargetConnectionString:"..."

方案2：直接使用绝对路径调用

无需修改PATH，直接用工具的绝对路径执行：

dotnet tool install --global microsoft.sqlpackage
~/.dotnet/tools/sqlpackage /Action:Publish [...]

方案3：配置代理全局环境变量（适合自建代理）

如果是自建Linux代理，可以将$HOME/.dotnet/tools添加到代理用户的全局PATH中：

• 编辑代理用户的~/.bashrc或~/.profile文件
• 添加一行：export PATH="$PATH:$HOME/.dotnet/tools"
• 重启代理服务，后续所有任务都会自动包含该路径

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