部署Dacpac时Master数据库引用错误：VS正常SqlPackage.exe报错

问题场景 #

我有一个包含存储过程的数据库项目，其中部分对象会访问系统功能，示例视图代码如下：

CREATE VIEW [dbo].[viewTest]
AS
    SELECT 
        sk.name as name
        ,sk.key_guid as key_guid      
        FROM sys.symmetric_keys sk
    WHERE name like 'TEST%'

未添加Master系统数据库引用时，VS中会报错：

View viewTest contains a not resolved reference...

添加Master数据库作为系统依赖后，VS中可正常构建和发布，但使用生成的MyDatabase.dacpac通过SqlPackage.exe发布时，出现以下错误：

Initializing deployment (Failed)
*** An error occurred during deployment plan generation. Deployment cannot continue.
Error SQL0: The reference to the external element with the name '[master]|[sys].[symmetrickeys]' could not be resolved. No such element exists.

尝试过两种SqlPackage命令，均出现相同错误：

1. 直接指定参数：

$SqlPackage /Action:Publish /tsn:"MyDbServer"  /p:TreatVerificationErrorsAsWarnings=True  /tec:False  /tdn:MyDatabase /tu:myUser  /tp:myPassword /sf:"dacpathPath"

2. 使用VS生成的发布配置文件：

$SqlPackage /Action:Publish /pr:"publish.xml" /sf:"dacpathPath"

原因分析 #

VS和SqlPackage.exe对系统数据库引用的处理逻辑存在差异：

• VS会自动识别sys架构下的对象为SQL Server内置系统对象，即使手动添加了Master引用，它也会优先使用内置的系统对象定义，不会严格校验外部引用的存在性。
• SqlPackage.exe在发布时，会将手动添加的Master数据库引用当作外部用户数据库处理，而非内置系统库。它会尝试查找[master].[sys].[symmetric_keys]这个用户级对象，但实际上sys架构是每个数据库都内置的，不存在跨库的用户级sys.symmetric_keys对象，因此报错。

解决方法 #

1. 移除项目中手动添加的Master数据库引用 #

打开VS数据库项目，右键点击引用 -> 找到已添加的Master引用，选择移除。

2. 确认项目目标平台匹配目标SQL Server版本 #

右键项目 -> 属性 -> 目标平台，选择与发布目标一致的SQL Server版本（如SQL Server 2019）。VS会自动加载对应版本的系统对象定义，确保sys架构下的对象能被正确识别。

3. 规范系统对象的引用方式（可选但推荐） #

对于sys架构下的系统对象，无需添加跨库引用，直接使用sys.xxx即可，因为sys是当前数据库的内置架构，访问的是实例级的系统视图。示例代码无需修改，保持原有写法即可：

CREATE VIEW [dbo].[viewTest]
AS
    SELECT 
        sk.name as name
        ,sk.key_guid as key_guid      
        FROM sys.symmetric_keys sk
    WHERE name like 'TEST%'

4. 重新生成并发布 #

重新构建项目生成新的dacpac包，使用以下优化后的SqlPackage命令发布（按需调整参数）：

$SqlPackage /Action:Publish `
    /tsn:"MyDbServer" `
    /tdn:MyDatabase `
    /tu:myUser `
    /tp:myPassword `
    /sf:"dacpathPath" `
    /p:TreatVerificationErrorsAsWarnings=True

如果使用发布配置文件，确保配置文件中没有添加外部Master数据库的引用配置。

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