VS2022数据库项目系统引用反复失效问题求助

1. 手动清理项目文件中的重复引用 #

从VS2019迁移到VS2022的数据库项目，容易在.sqlproj文件中生成重复的系统数据库引用条目，导致重启后加载异常：

• 关闭VS解决方案，找到项目根目录下的.sqlproj文件，用文本编辑器打开
• 查找所有包含master.dacpac和msdb.dacpac的<ArtifactReference>节点，删除重复的条目，每个系统数据库仅保留一份引用，示例正确条目如下：

  <ArtifactReference Include="$(DacPacRootPath)\Extensions\Microsoft\SQLServer\$(SqlServerVersion)\SqlSchemas\master.dacpac">
    <HintPath>$(DacPacRootPath)\Extensions\Microsoft\SQLServer\$(SqlServerVersion)\SqlSchemas\master.dacpac</HintPath>
    <SuppressMissingDependenciesErrors>False</SuppressMissingDependenciesErrors>
    <DatabaseVariableLiteralValue>master</DatabaseVariableLiteralValue>
  </ArtifactReference>
  <ArtifactReference Include="$(DacPacRootPath)\Extensions\Microsoft\SQLServer\$(SqlServerVersion)\SqlSchemas\msdb.dacpac">
    <HintPath>$(DacPacRootPath)\Extensions\Microsoft\SQLServer\$(SqlServerVersion)\SqlSchemas\msdb.dacpac</HintPath>
    <SuppressMissingDependenciesErrors>False</SuppressMissingDependenciesErrors>
    <DatabaseVariableLiteralValue>msdb</DatabaseVariableLiteralValue>
  </ArtifactReference>
  

• 保存文件后重新打开解决方案

2. 升级项目至VS2022兼容格式 #

VS2019与VS2022的数据库项目格式存在细微差异，执行升级可消除兼容性问题：

• 在VS2022中右键点击数据库项目，选择属性
• 切换到项目设置标签页，确认目标平台为当前使用的SQL Server版本（如SQL Server 2022），若版本不符则修改后点击应用
• 右键项目选择重新生成，确保项目完整编译

3. 清除VS本地缓存 #

VS的缓存文件可能导致引用加载逻辑异常，清理步骤如下：

• 完全关闭VS程序
• 删除项目目录下的.vs隐藏文件夹
• 删除路径%LOCALAPPDATA%\Microsoft\VisualStudio\17.0_<随机标识>\ComponentModelCache下的所有文件
• 重新启动VS并打开解决方案

4. 规范添加系统数据库引用的流程 #

避免手动重复添加导致的异常，使用官方标准流程添加引用：

• 右键数据库项目 -> 添加 -> 数据库引用
• 在弹出窗口中选择系统数据库分类，勾选master和msdb后点击确定
• 检查.sqlproj文件，确认仅生成了单个master和msdb引用条目

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