Azure DevOps部署Synapse CI/CD Pipeline新增Notebook后部署失败

该报错和ARM模板长度超限无关，模板长度超限会直接返回模板大小相关的明确错误码，不会抛出资源级空引用提示。
报错核心原因是出问题的SilverToGoldPipeline notebook导出的ARM模板中存在空字符串的引用字段，触发Synapse控制面的资源校验失败：

• 低环境notebook编辑态会自动使用临时会话资源兜底，即使没显式绑定默认Spark池、关联资源引用留空，也能正常调试运行，不会触发校验
• 导出ARM模板做跨环境部署时，未配置的引用字段会被序列化为空字符串，高环境部署没有临时会话兜底逻辑，校验到空引用就会直接返回invalid reference ''错误
  最常见的触发场景是新增notebook时忘记选择默认绑定的Spark池，其次是notebook内引用了未纳入本次部署工件的其他notebook/管道资源，导致模板生成时引用位自动留空。

按以下步骤操作即可恢复部署：

1. 定位故障notebook：直接在低环境Synapse Studio打开日志中标记的SilverToGoldPipeline notebook，打开右上角配置面板逐项校验：
   • 确认默认Spark池选择了环境中真实存在的实例，禁止留空或选择「无」
   • 检查所有关联存储挂载、引用数据集/管道的配置项，不存在空值占位
   • 检查单元格代码，确认mssparkutils.notebook.run()等跨资源调用的路径参数没有留空、没有硬编码低环境专属路径
2. 校验配置无误后保存notebook，重新触发CI流程生成新的ARM模板包，解压后定位到该notebook对应的JSON定义段，重点检查bigDataPoolReference、relatedArtifactReference、targetNotebookPath字段，确认不存在值为""的空配置。
3. 若后续需批量新增notebook，可在CD部署任务前增加一段预处理脚本，遍历模板内所有notebook资源定义，自动给空的Spark池引用字段填充高环境默认池的资源ID，避免漏选配置导致的部署失败。

验证提示：Synapse部署任务返回的BadRequest如果带invalid reference ''且明确标记notebook名称，90%以上的触发原因都是notebook未绑定默认Spark池，优先检查该项可快速定位问题。

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