Maven构建项目遇'sqlpackage.exe'未识别错误，求排查方案

你的Maven构建过程需要调用sqlpackage.exe工具，但系统找不到它——这是因为这个工具属于SQL Server Data Tools (SSDT)，要么没安装SSDT，要么它的路径没加到系统环境变量里。下面是一步步的解决方法：

1. 确认安装SQL Server Data Tools (SSDT) #

SSMS 17默认并没有包含完整的SSDT组件，你需要单独安装适配SQL Server 14.0的SSDT版本。安装时要确保勾选包含sqlpackage.exe的相关组件。

2. 定位sqlpackage.exe的安装路径 #

安装完成后，你可以在以下常见路径找到它：

• 对应SQL Server 14的默认路径：C:\Program Files\Microsoft SQL Server\140\DAC\bin
• 如果是单独安装的SSDT，路径可能是：C:\Program Files (x86)\Microsoft SQL Server\150\DAC\bin（具体版本号可能略有差异，根据你的安装版本调整）

3. 添加路径到系统环境变量PATH #

打开系统环境变量设置：

• 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
• 在「系统变量」里找到Path，点击「编辑」
• 添加你找到的sqlpackage.exe所在的文件夹路径
• 点击确定保存，然后必须重启命令行窗口或者IDE（环境变量修改后需要重新加载才会生效）

4. 验证配置是否生效 #

打开一个新的命令提示符，输入：

sqlpackage.exe

如果能看到工具的帮助信息，说明配置成功了，这时再重新运行Maven构建应该就不会报错了。

备选方案：直接在Maven插件里指定路径 #

如果不想修改环境变量，也可以在你的Maven插件配置里直接指定sqlpackage.exe的绝对路径。比如使用微软的SQL Server Maven插件时，可以这么配置：

<plugin>
    <groupId>com.microsoft.sqlserver</groupId>
    <artifactId>sqlserver-maven-plugin</artifactId>
    <version>1.0.0</version> <!-- 使用对应版本号 -->
    <configuration>
        <sqlPackagePath>C:\Program Files\Microsoft SQL Server\140\DAC\bin\sqlpackage.exe</sqlPackagePath>
        <!-- 其他插件配置项 -->
    </configuration>
</plugin>

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