如何在SSDT发布过程中阻止同义词被删除并重建？

针对你遇到的SSDT每次发布都会删除并重建同义词的问题，结合你不想启用“删除多余对象”选项、且有存储过程管理环境特定同义词目标的场景，这里有几个实用的解决方案：

1. 单个/批量设置同义词的“忽略比较”属性 #

你之前尝试修改生成操作导致编译失败，不妨试试调整同义词的比较属性，让SSDT在发布对比时跳过这些对象：

• 单个同义词设置：右键项目中的同义词 → 属性，找到“比较”相关选项（不同SSDT版本表述可能略有不同，比如“忽略对象”或“不参与比较”），勾选后保存。
• 批量设置（适合多个同义词）：直接编辑.sqlproj文件，找到每个同义词的<SqlObject>条目，添加<Compare>False</Compare>属性：

  <SqlObject Include="dbo.MY_SYNONYM.sql">
    <Compare>False</Compare>
  </SqlObject>
  

这样SSDT生成发布脚本时，就不会将该同义词纳入项目与目标环境的对比，自然不会生成DROP/CREATE语句。

2. 使用部署贡献者自定义部署逻辑 #

如果需要更灵活的控制（比如只跳过目标未变更的同义词，而非全部忽略），可以通过SSDT的部署贡献者扩展来拦截部署步骤：

• 创建一个实现IDeploymentContributor接口的C#类，在OnExecute方法中遍历部署计划，移除针对同义词的DROP和CREATE步骤：

  public class SkipSynonymDeploymentContributor : IDeploymentContributor
  {
      public void OnExecute(DeploymentContributorContext context)
      {
          var stepsToRemove = context.PlanHandle.Plan.Steps
              .Where(step => step is DropSynonymStep || step is CreateSynonymStep)
              .ToList();
  
          foreach (var step in stepsToRemove)
          {
              context.PlanHandle.Plan.Steps.Remove(step);
          }
      }
  
      // 实现其他接口方法（如OnEstablishDeploymentConfiguration等，可留空或默认实现）
  }
  

• 将编译后的DLL添加到SSDT项目的部署贡献者配置中：编辑.sqlproj文件，添加以下节点：

  <PropertyGroup>
    <DeploymentContributors>YourNamespace.SkipSynonymDeploymentContributor</DeploymentContributors>
    <DeploymentContributorArguments>ContributorPath=path/to/your/contributor.dll</DeploymentContributorArguments>
  </PropertyGroup>
  

这个方法可以精准控制哪些操作被跳过，甚至可以扩展逻辑，对比sys.synonyms中的目标与项目定义，只跳过未变更的同义词。

3. 全局忽略同义词的发布对比（谨慎使用） #

如果你的项目中所有同义词都不需要由SSDT管理，可以在发布配置的高级选项中设置：

• 打开发布配置的“高级”设置，找到“忽略对象类型”，将“同义词”添加到列表中。
• 注意：这会全局忽略所有同义词的对比，适合所有同义词都由存储过程管理的场景，若有部分同义词需要SSDT维护则不适用。

测试建议 #

无论用哪种方法，都建议先点击“生成脚本”预览发布内容，确认同义词的DROP/CREATE语句已被移除后，再执行实际发布操作，避免影响现有环境。

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