Azure Synapse Analytics Pipeline存储文件触发器未触发问题排查

• 检查存储账户的核心配置

  • 确认存储账户是StorageV2（通用v2）或Blob存储类型，且已启用分层命名空间（ADLS Gen2）——只有这类存储才支持Synapse的Blob事件触发逻辑。
  • 核对触发规则里的容器和文件夹路径：路径区分大小写，比如配置的是container/test/，但文件传到container/Test/就不会触发；如果设置了文件夹筛选，必须保证文件完全落在指定子路径下。
  • 确认触发的事件类型是BlobCreated，若勾选了“仅当Blob完成时触发”，分块上传未完成的Blob不会触发事件。

• 验证Synapse触发的权限配置

  • 确保Synapse工作区的托管标识对目标存储账户有足够权限：至少需要Storage Blob Data Contributor角色，或者包含Microsoft.Storage/storageAccounts/blobServices/containers/blobs/read和Microsoft.Storage/storageAccounts/blobServices/containers/blobs/write的自定义权限——触发逻辑需要读取Blob元数据。
  • 检查触发的连接配置：确认使用托管标识认证的存储连接已正确关联，且该标识确实有访问存储账户的权限。

• 核查事件网格的隐性订阅状态

  • Synapse的Blob触发会自动创建事件订阅，去存储账户的「事件」→「事件订阅」页面查看，是否存在由Synapse工作区创建的订阅，且状态为「已启用」——如果订阅被删除或禁用，事件就无法投递。
  • 查看事件网格的死信队列：如果事件投递失败，会被存入死信队列，里面的失败日志能帮你定位具体问题（比如权限不足、路径不匹配）。

• 确认管道与触发的启用状态

  • 检查触发本身是否处于已启用状态：在Synapse Studio的「集成」→「触发」页面，确认目标触发的状态不是「已禁用」。
  • 验证触发与管道的关联：进入触发编辑页面，确认「触发的管道」是你要启动的目标管道，参数映射（如果有）配置正确。

• 排查文件上传方式的影响

  • 分块上传的Blob必须调用CommitBlockList完成提交后，才会触发BlobCreated事件；如果用SDK或AzCopy批量上传，要确保文件已完全提交。
  • 避免用零字节文件测试：部分场景下零字节文件不会触发事件，改用非空文件验证。

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