SSDT构建遇SQL71501/71502错误：引用元数据生成对象的替代方案？

针对SSDT项目中非元数据对象引用部署后才生成的元数据对象导致的未解析引用错误，除创建对象存根外，还有以下几种替代方法：

1. 抑制特定未解析引用警告 #

全局抑制 #

在SSDT项目的.csproj文件中添加配置，全局屏蔽指定警告：

<PropertyGroup>
  <SuppressTSqlWarnings>71501;71502</SuppressTSqlWarnings>
</PropertyGroup>

注意：该方式会屏蔽所有同类型警告，可能掩盖真正的引用错误，建议仅在确认所有相关警告均由元数据对象导致时使用。

单个对象抑制 #

在触发警告的对象定义顶部添加注释，仅抑制该对象的指定警告：

-- Suppress Message: SQL71501
CREATE VIEW [dbo].[whatever]
AS
SELECT * FROM [schema].[functionName](GETDATE())

这种方式更精准，不会影响其他对象的错误检查。

2. 利用SQLCMD变量实现条件式存根 #

在项目中添加带条件的对象定义，仅在开发构建时生成存根，部署时不创建：

1. 在项目属性的「SQLCMD变量」中添加IsDevBuild，默认值设为True。
2. 创建对象定义文件，内容如下：

IF $(IsDevBuild) = 'True'
BEGIN
  -- 仅开发环境存在的存根
  CREATE FUNCTION [schema].[functionName] (
    @param DATETIME
  ) RETURNS TABLE
  AS RETURN
  SELECT
    NULL AS [RecordId]
  , CAST(NULL AS DATETIME) AS [FromDateTime]
  WHERE 0 = 1
END

3. 部署时将IsDevBuild设为False，此时存根不会被创建，由部署后脚本生成真实对象。
   该方式避免了单独维护存根文件，同时让SSDT在开发时能正常解析引用。

3. 使用外部数据库引用提供对象定义 #

1. 创建一个新的空SSDT项目，在其中添加元数据生成对象的完整定义（仅用于SSDT解析，无需实际部署）。
2. 在主SSDT项目中添加对这个空项目的数据库引用。
3. 部署时仅部署主项目，空项目不参与部署，主项目的部署后脚本生成真实的元数据对象。
   这种方式让SSDT通过外部引用识别对象结构，无需在主项目中添加存根，同时保留了编译时的引用检查。

4. 改用动态SQL避免静态引用 #

如果是存储过程或函数中的引用，可以将静态引用改为动态SQL：

CREATE PROCEDURE [dbo].[proc_name]
AS
BEGIN
  DECLARE @sql NVARCHAR(MAX) = N'SELECT [column] FROM [schema].[table_name]'
  EXEC sp_executesql @sql
END

SSDT不会解析动态SQL中的对象引用，因此不会触发警告。但该方式会失去编译时的语法和引用检查，可能导致运行时错误，需谨慎使用。

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