Azure DevOps中Synapse workspace deployment@2任务执行失败求助

我尝试在Azure Pipeline中运行Synapse workspace deployment@2任务，配置如下：

- task: Synapse workspace deployment@2
  continueOnError: false
  inputs:
    TargetWorkspaceName: 'dev'
    ArtifactsFolder: $(ARTIFACTS_FOLDER)
    operation: 'validate'

同时也尝试了validateDeploy操作：

- task: Synapse workspace deployment@2
  continueOnError: false
  inputs:
    operation: 'validateDeploy'
    ArtifactsFolder: '$(ARTIFACTS_FOLDER)'
    azureSubscription: '$(AZURE_RESOURCE_MANAGER_CONNECTION_NAME)'
    ResourceGroupName: '$(TARGET_RESOURCE_GROUP_NAME_DEV)'
    TargetWorkspaceName: '$(TARGET_WORKSPACE_NAME_DEV)'
    DeleteArtifactsNotInTemplate: false
    DeployManagedPrivateEndpoints: false
    FailOnMissingOverrides: false
    Environment: 'prod'
    npmpackage: 'prod'

但执行时出现如下错误：

Stdout: WARNING === BaseFileResourceProviderService: _processResource - Failed to load resource, loadingError: NameMismatch, Error: NameMismatch.
Stdout: ModelService: fetchAllInBackground - start
Stdout: ModelService: synchronize - finished
Stdout: ModelService: _backgroundFetch - finished, duration: 5.226471000001766, total nameds: 0
Stdout: ModelService: _backgroundFetch - finished, total unknown model types
Stdout: CmdApiApp: Publishable resource count: 0
Stdout: ERROR === CmdApiApp: Failed to export Synapse template. Error: {"stack":"TypeError: Cannot read properties of undefined (reading 'parameters')\n at PublisherUtils.createGlobalParametersForArmTemplate (/home/vsts/work/1/s/downloads/main.js:180026:54)\n at Function. (/home/vsts/work/1/s/downloads/main.js:250303:136)\n at step (/home/vsts/work/1/s/downloads/main.js:441160:17)\n at Object.next (/home/vsts/work/1/s/downloads/main.js:441091:14)\n at fulfilled (/home/vsts/work/1/s/downloads/main.js:441046:24)","message":"Cannot read properties of undefined (reading 'parameters')"}
Shell execution failed.
An error occurred during execution: Shell execution failed.
##[error]Encountered with exception:Shell execution failed.
Finishing: Synapseworkspacedeployment

我已尝试修改所有输入参数，但错误仍然存在，请求解决方法。

从报错信息中的Cannot read properties of undefined (reading 'parameters')和Publishable resource count: 0来看，核心问题集中在工件完整性或全局参数配置上，按以下步骤排查：

• 检查工件文件夹内容
  确认$(ARTIFACTS_FOLDER)指向的目录包含完整的Synapse导出工件，重点检查：

  • 是否存在WorkspaceName.json和GlobalParameters文件夹（若使用全局参数）；
  • 工件是否通过Synapse workspace export任务正确生成，无文件缺失或命名错误（对应警告里的NameMismatch）；
  • 手动遍历目录，确认没有损坏或空的资源文件。

• 修复全局参数配置

  • 若工作区使用全局参数，确保GlobalParameters文件夹存在且参数文件格式正确；
  • 若无需全局参数，在任务中添加OverrideParameters显式指定必要参数，示例：

    OverrideParameters: '-workspaceName $(TARGET_WORKSPACE_NAME_DEV)'
    

• 调整任务配置

  • 给validate操作补充azureSubscription和ResourceGroupName参数，确保任务能正确访问工作区；
  • 移除非必要参数（如npmpackage，该参数不属于Synapse部署任务的标准配置，可能引发冲突）；
  • 尝试切换到Synapse workspace deployment@3版本，旧版本可能存在已知bug。

• 验证本地环境
  使用Azure CLI在本地执行az synapse workspace validate命令，传入相同的工件文件夹，确认是否复现错误，排除Pipeline代理环境问题。

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