如何在MSBuild中关闭未解析引用检查？解决SQL71561错误

错误原因 #

SQL71561是项目构建时的静态分析错误，本质是当前项目找不到视图/存储过程依赖的对象：要么是依赖对象没被正确包含进项目，要么是跨数据库引用的配置缺失。你用*.sql批量导入对象时，若依赖的对象（比如其他库的表、当前库漏导的表）不在项目范围内，就会触发这个错误——SQL项目构建不像直接在数据库执行，它会严格校验所有引用的有效性。

关于“忽略错误”的说明 #

SQL71561属于错误级别问题，MSBuild没有直接忽略这类错误的官方配置（仅支持忽略警告）。强行通过非常规手段屏蔽错误会导致构建出的dacpac包含无效对象，部署时大概率出错，因此不推荐这么做。

正确解决思路 #

1. 确保当前项目包含所有依赖对象 #

如果引用的对象属于当前数据库，检查你的通配配置是否覆盖完整：

• 打开.sqlproj，确认所有对象目录都配置了Build Include，示例：

  <ItemGroup>
    <Build Include="Tables\*.sql" />
    <Build Include="Views\*.sql" />
    <Build Include="Stored Procedures\*.sql" />
    <!-- 其他对象目录同理 -->
  </ItemGroup>
  

• 若有嵌套子目录，改用递归匹配：Build Include="Tables\**\*.sql"
• 重新用VS“架构对比”导入时，务必勾选所有依赖对象，避免漏导。

2. 跨数据库引用的dacpac解决方案 #

如果引用的对象来自其他数据库，dacpac是标准处理方式，你的疑问可以这样解决：

• 新增表是否需要更新dacpac？
  是的。当被引用数据库的结构变更（新增/修改表、视图等），需要重新生成最新的dacpac并替换项目中的引用。可以把被引用库的dacpac生成加入DevOps流水线，实现自动同步更新。
• 被引用库迁入测试环境后，如何让MSBuild找到？
  1. 在VS2019中右键项目→添加→数据库引用
  2. 选择“dacpac文件”，指定被引用库的dacpac路径；如果被引用库也是DevOps中的SQL项目，直接选择项目依赖即可
  3. 项目的.sqlproj会自动生成类似配置：

     <ItemGroup>
       <ArtifactReference Include="..\OtherDatabase\bin\Debug\OtherDatabase.dacpac">
         <HintPath>..\OtherDatabase\bin\Debug\OtherDatabase.dacpac</HintPath>
         <SuppressMissingDependenciesErrors>False</SuppressMissingDependenciesErrors>
       </ArtifactReference>
     </ItemGroup>
     

  4. 在DevOps流水线中，需将dacpac作为构件（Artifact）上传，构建当前项目时下载到HintPath指定的路径，确保MSBuild能正确读取。

3. 临时规避方案（仅紧急场景使用） #

如果必须暂时绕过错误，可以将SQL71561降级为警告，在.sqlproj的PropertyGroup中添加：

<SqlSeverity>
  <ErrorSeverity>
    <71561>Warning</71561>
  </ErrorSeverity>
</SqlSeverity>

注意：这只是临时手段，会掩盖潜在的部署风险，不建议长期使用。

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